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Introduction 


S taring back at me on the screen was an image I recognized: a face—my face. 
Grainy and pixelated, it was stili me. 1 watched with detached curiosity as 
my expression twisted and contorted beyond human limits until finally, 
an alien embryo burst from my head. A voice behind me said, “You wanna see it 
again?” 

No, this wasn’t some horrible dream, it was my job. 1 worked at a company pro- 
ducing and designing computer games. 1 also got to “star” in our first release, an 
adventure game where the player clicks me around the screen. And if the player 
fails to solve the game in time... well, 1 think you know how that turns out. Fve 
also worked as a programmer for a major Internet Services company, traveling to 
sites around the country. And while those two lines of work may seem quite dif¬ 
ferent, the basic skills necessary to succeed in each started to take shape while 1 
wrote simple games on my horne computer as a kid. 

The goal of this book is to teach you the Python programming language, learning 
to program the same way 1 did: by creating simple games. There’s something more 
exciting about learning to program by writing Software thafs fun. And even 
though the examples are entertaining, youTl stili see some serious programming. 
1 cover all of the fundamental topics you’d expect from an introductory text and 
then some. In addition, 1 point out concepts and techniques that you can apply to 
more mainstream projects. 

lfyou’re new to programming, you’ve made the right choice. Python is the perfect 
beginners’ language. It has a ciear and simple syntax that will get you writing 
useful programs in short order. Python even has an interactive mode, which offers 
immediate feedback, allowing you to test out new ideas almost instantly. 

If youVe done some programming before, you’ve stili made the right choice. 
Python has all the power and flexibility you’d expect from a modern, object- 
oriented programming language. But even with all of its power, you may be 
surprised how quickly you can build programs. In fact, ideas translate so quickly 
to the computer, l^thon has been called “programming at the speed of thought.” 

Like any good book, this one starts at the beginning. The first thing 1 cover is in- 
stalling Python under Windows. Then, 1 move through concepts, one step at a time. 


Python Programming for the Absolute Beginner, Third Edition 



by writing small programs to demonstrate each step. By the end of the book, FU have covered 
such fancy-sounding topics as data structures, file handling, exceptions, object-oriented de- 
sign, and GUI and multimedia programming. I also hope to show you how to design as well 
as program. You’11 learn how to organize your work, break problems down into manageable 
chunks, and refine your code. You’11 be challenged at times, but never overwhelmed. Most of 
all, you’11 have fun while learning. And in the process, you’11 create some small, but cool 
computer games. 

All of the code for the programs presented in this book, along with necessary supporting 
files, can be downloaded from the companion website (www.courseptr.com/downloads). The 
website also includes installers for the Software you’11 need to run the programs. You can find 
a more detailed description of whafs available on the wehsite in Appendix A, “The Companion 
Website.” 

Throughout the journey, Fll offer a few signposts to highlight important concepts. 

These are good ideas that experienced programmers Like to pass on. 


There are a few areas where it's easy to make a mistake. I'LL point them out. 


These wiLL suggest techniques and shortcuts that wiLL make your Life as a pro- 
grammer easier. 



\ 

In THE Real World 

As you examine the games in this book, TU show you how the concepts are used for purposes 
beyond game development. 

- 




Introduction 



f ^ 

Challenges 

At the end of each chapter, TU suggest some programs thatyou can write 
with the skills you’ve learned. 
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Getting Started: The 
Game Over Program 


P rogramming basically is getting your computer to do stuff. This is not the 
most technical definition, but it’s a pretty accurate one. By learning 
Python, you’11 be able to create a program, whether it’s a simple game, a 
small utility, or a business product with a full-featured graphical user interface 
(GUI). It’11 be ali yours, something you made, and it will do just what you told it 
to. Programming is part Science, part art, and one great adventure. This chapter 
starts you on your Python programming journey. In it, youTl learn: 

• What P 5 b;hon is and whafs so great about it 
• How to install Python on your computer 
• How to print text to the screen 
• What comments are and how to use them 

• How to use P 5 ^hon’s integrated development environment to write, edit, run, 
and save your programs 

Examining THE Game Over Program 

The chapter project, Game Over, displays the two most infamous words in com¬ 
puter gaming: “Game Over.” Figure 1.1 shows the program in aedon. 
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Q Figure i.i ^ 


from a computer 
game. 


The alL-too 
familiar words 



Figure 1.1 shows whafs called a console window, a window that can display only text. Though 
not as nice as Windows in a Graphical User Interface (GUI), console applications are easier to 
write and a good place for the beginning programmer to start. 

The Game Over program is pretty simple; in fact, it’s one of the simplest Python programs 
you can write. Thafs the reason it’s presented in this chapter. By completing such a modest 
program, you cover all the setup work required to start programming in Python, such as 
installing the language on your system. You also work through the entire process of writing, 
saving, and running a program. Once you finish all of this groundwork, youTl be ready to 
tackle larger programs with some real meat to them. 

/ \ 


In THE Real World 


The Game Over program is really just a variation of the traditional Helio World pro¬ 
gram, whichdisplays the words “Helio World" on the screen. The Helio World program 
is often the first program a beginner writes in order to dip his or her toe in a new 
language. It's such a common first program that Helio World is an understood term 
in programming. 
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Introducing Python 

Python is a powerful yet easy-to-use programming language developed by Guido van Rossum, 
first released in 1991. With P 5 d;hon, you can quicldy write a small project. But Python also 
scales up nicely and can be used for mission-critical, commercial applications. 

If you check out any Python documentation, you may notice an alarming number of refer- 
ences to spam, eggs, and the number 42. These references all pay homage to Monty Python, 
the English comedy troupe that inspired Python’s name. Even though Guido van Rossum 
named Python after the group, the official mascot of the language has become the p 5 d;hon 
snake. (Which is really for the best, since it would be pretty hard to fit six British comedians’ 
faces on a program icon anyway.) 

There are a lot of programming languages out there. Whafs so great about Python? Let me 
teli you. 

Python Is Easy to Use 

The major goal of any programming language is to bridge the gap between the programmer’s 
brain and the computer. Most of the popular languages you’ve probably heard of, like Visual 
Basic, G#, and Java, are considered high-level languages, which means that they’re closer to 
human language than machine language. And they are. But lython, with its ciear and simple 
rules, is even closer to English. Creating Python programs is so straightforward that it’s been 
called “programming at the speed of thought.” P 5 d;hon’s ease of use translates into produc¬ 
tivi ty for professional programmers. Python programs are shorter and take less time to create 
than programs in many other popular languages. 

Python Is Powerful 

Python has all the power you’d expect from a modern programming language. By the end of 
this book, you’ll be able to write programs that employ a GUI, process files, and use a variety 
of data structures. 

Python is powerful enough to attract developers from around the world as well as companies 
such as Google, IBM, Industrial Light + Magic, Microsoft, NASA, Red Hat, Verizon, Xerox, and 
Yahoo!. I^thon is also used as a tool by professional game programmers. Electronic Arts, 2K 
Games, and the Disney Interactive Media Group all publish games that incorporate Python. 

Python Is Object-Oriented 

Object-Oriented programming (OOP) is a modern approach to solving problems with computers. 
It embodies an intuitive method of representing information and actions in a program. lt’s 
certainly not the only way to write programs, but, for large projects, it’s often the best way 
to go. 
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Languages like C#, Java, and Python are ali object-oriented. But Python does them one better. 
In C# and Java, OOP is not optional. This makes short programs unnecessarily complex, and 
it requires a bunch of explanatiori before a new programmer can do anything significant. 
Python takes a different approach. In Python, using OOP techniques is optional. You have all 
of OOP’s power at your disposal, but you can use it when you need it. Got a short program 
that doesn’t really require OOP? No problem. Got a large project with a team of programmers 
that demands OOP? That’11 work too. Python gives you power and fiexibility. 

Python Is a "Glue" Language 

Python can be integrated with other languages such as G, G++, and Java. This means that a 
programmer can take advantage of work already done in another language while using 
Python. It also means that he or she can leverage the strengths of other languages, such as 
the extra speed that G or G++ might offer, while stili enjoying the ease of development thafs 
a hallmark of Python programming. 

Python Runs Everywhere 

Python runs on everything from a Palm to a Gray. And if you don’t happen to have a super- 
computer in the den, you can stili run Python on Windows, Macintosh, or Linux machines. 
And thafs just the top of the list. 

Python programs are plalform independent, which means that regardless of the operating Sys¬ 
tem you use to create your program, if 11 run on any other computer with Python. So if you 
write a program on your PG, you can e-mail a copy to your friend who runs Linux or to your 
aunt who has a Mac, and the program will work (as long as your friend and aunt have Python 
installed on their computers). 

Python Has a Strong Community 

Most programming languages have a dedicated newsgroup, but Python also has something 
called the Python Tutor mailing list, a more informal way for beginning programmers to ask 
those first questions. The list is at http://maiLpython.org/mailman/listinfo/tutor. Although 
the list is called Tutor, anyone, whether novice or expert, can answer questions. 

There are other P 5 d:hon communities focused on different areas, but the common element 
they share is that they tend to be friendly and open. That only makes sense since the language 
itself is so approachable for beginners. 
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Python Is Free and Open Source 

Python is free. You can install it on your computer and never pay a penny. But Python’s license 
lets you do much more than that. You can copy or modify P 5 d;hon. You can even resell Python 
if you want (but don’t quit your day job just yet). Embracing open-source ideals like this is 
part of what makes Python so popular and successful. 

Setting Up Python on Windows 

Before you can jump in and write your first Python program, you need to get the language 
on your computer. But don’t worry—Fll walk you through the process of installing Python on 
a Windows machine. 

Installing Python on Windows 

To install Python under Windows, follow these steps: 

1. Download the Python Windows installer from the companion website (www.courseptr. 
com/downloads). The file is in the Software folder, inside the Python subfolder; the file 
name is python-S.l.msi. 

2. Run the Python Windows Installer, p5d;hon-3.1.msi. Figure 1.2 shows the installer in 
action. 

3. Accept the default configuration. Once you’re done, youTl have Python 3.1 on your 

The companion website for this book can be found at www.courseptr.com/ 
downLoads. It hosts the code for every complete program presented in these 
pages, along with alL necessary supporting files and Software installers. You can 
find a more detailed description of what's available in Appendix A, "The 
Companion Website." 


System. 
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Figurei.2 ^ 

Your computer is 
soon to be horne 
to Python. 



Setting Up Python on Other Operating Systems 

Python runs on literally dozens of other operating systems. So, ifyouhe running something 
other than Windows, he sure to visit the official Python website, http://www.python.org, to 
download the latest version of the language for your machine. You can check out the Python 
horne page in Figure 1.3. 
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Figure 1.3 
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Visit Python's 
horne page to 
downLoad the 
Latest version of 
Python and read 
Loads of 

information about 
the Language. 
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Your computer may have Python preinstaLLed; however, you must be using 
Python 3 in order for the programs in this book to work correctLy. 


Introducing IDLE 

Python comes with an integrated development environment called IDLE. A development envi- 
ronment is a set of tools that makes writing programs easier. You can think of it as a word 
processor for your programs. But it’s even more than a place to write, save, and edit your 
work. IDLE provides two modes in which to work: an interactive mode and a script mode. 


Programming in Interactive Mode 

Finally, it’s time to getyour hands dirty with some actual Python programming. The quickest 
way is to start I^thon in interactive mode. In this mode, you can teli I^thon what to do and 
itTl respond immediately. 

Writing Your First Program 

Tobeginyour interactive session, from the Start menu, choose All Programs, I^thon 3.1, IDLE 
(Python GUI). You should see something very similar to Figure 1.4 on your screen. 



Figure 1.4 ^ 

Python in an 
interactive 
session, awaiting 
your command. 









Python Programming for the Absolute Beginner, Third Edition 



This window is called the Python Shell. At the command prompt (>>>), type printCGame 
Over" ) and then press the Enter key. The interpreter responds hy displaying the following on 
the screen: 

Game Over 

Ta da! You’ve written your first Python program! You’re a real programmer (with a little more 
to learn, but that goes for all of us). 


Usingthe print Function 

Take a look at the line you entered, printCGame Over"). Notice how straightforward it is. 
Without knowing an 5 d;hing about programming, you could have probably guessed what it 
does. Thafs P 5 d;hon in a nutshell. lt’s concise and ciear. YouTl appreciate this even more as 
you learn how to do more complex things with the language. 

The pri nt( ) function can display text, surrounded by quotes, that you put inside the pair of 
parentheses. If you put nothing inside the parentheses, it will print a blank line. 



Python is case-sensitive and by convention, function names are in Lowercase. So, 

printCGame Over") wiLL work, but PrintCGame Over") and PRINTCGame 
Over" ) won't. 


Learning the Jargon 

Now that you’re a programmer, you have to throw around those fancy terms that only pro- 
grammers understand. A function is like a mini-program that goes off and performs some 
specific task. The task of the pri nt () function is to display a value (or sequence of values). You 
Idck off, or call, a function by using the function name, followed by a set of parentheses. You 
did j ust this in interactive mode when you typed printCGame Over"). Sometimes you can give, 
or pass, a function values to work with. You put these values, called arguments, between the 
parentheses. In the case ofyour first program, you passed the pri nt( ) function the argument 
"Game Over", which the function used to display the message Game Over. 

Functions in Python also return or provide information back to the part of the 
program that called the function. These values are called return vaLues. YouTl 
learn more about return values in Chapter 2. 



In this particular case, you canbe even more specific by sa 5 dng that the value "Game Over" you 
passed the pri nt( ) function is a string. This just means that it’s a series of characters, like the 
ones on your keyboard. “String” may seem like an odd name—“text” or “words” might be more 
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ciear—but the name comes from the idea that text is a string, or a series, of characters. Tech- 
nically, "Game Over" is a string literal because it is literally the sequence of characters that 
make up the words. 

The line you entered in the interpreter is also considered a statement. In English, a statement 
is a complete thought. In Python, a statement is a complete instruction. It does something. 
Every program contains a number of statements. 

Finally, now that you’re a programmer, you can teli someone that you wrote some Python 
code. Code means programming statements. You can also use it as a verb to mean the act of 
programming. For example, you can say that you were up all night eating Hot Cheetos, drink- 
ing Mountain Dew, and coding like crazy. 

Generatingan Error 

Computers take ever 5 d;hing literally. If you misspell a function name by even just one letter, 
the computer will have absolutely no idea what you mean. For example, at the Interactive 
prompt, if 1 type primti "Game Over" ), the interpreter will respond with something like: 

Traceback (most recent call last): 

File "<pyshel1#0>", line 1, in <module> 
primtCGame Over") 

NameError: name 'primt' is not defined 

Translated to English, the interpreter is saying “Huh?!” The key line in the error message is 
NameError: name 'primt' is not defined. The message States that the interpreter doesn’trec- 
ognize primt. As a human being, you can ignore my typo and understand what 1 meant. 
Computers are not so forgiving. Luckily, programming errors, or bugs, like this can be easily 
resolved by fixing the offending typo. 

Understanding Syntax HighLighting 

You probably noticed that words on the screen are displayed in different colors (not in the 
book, of course). This color-coding, called syntax highlighting, helps you quickly understand 
what you’ve typed by visually categorizing it. And there is a method to this coloring madness. 
Special words that are a part of the Python language, like print, are displayed in purple. 
Strings, like "Game Over", are in green. And the output—what the interpreter displays as a 
resuit of what you t 3 q)e—is in blue. As you write larger programs, this color scheme will come 
in handy by helping you take in your code in one glance and spot errors more easily. 


Python Programming for the Absolute Beginner, Third Edition 



Programming in Script Mode 

Using the Interactive mode gives you immediate feedback. This is great because you can see 
the results. But it’s not designed to create programs you can save and run later. Luckily, 
Python’s IDLE also offers a script mode, in which you can write, edit, load, and save your 
programs. lt’s like a word processor for your code. In fact, you can perform such familiar tasks 
as find and replace, and cut and paste. 

Writing Your First Program (Again) 

You can open a script mode window from the interactive window youVe been using. Select 
the File menu, then New Window. A new window will appear that looks just like the one in 
Figure 1.5. 


Figurei.5 ^ 

Your bLank canvas 
awaits. Python is 
ready foryou to 
write a program in 
script mode. 


r- 

Untitled 


1 File Edit Format Run Options Windows Help 




In this new script window, t 5 rpe pri nt( "Game Over" ) and press Fnter. Nothinghappens! Thafs 
because you’re in script mode. What you’re doing is writing a list of statements for the com¬ 
puter to execute later. Once you save your program, you can run it. 
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Saving and Running Your Program 

To save your program, select File, Save As. I gave my copy the name game_over.py. To make it 
easy to get to later, 1 saved it on my desktop. 

Make sure to save your programs with the .py extensiori. This aLLows various 
appLications, incLuding IDLE, to recognize these files as Python programs. 



To run my Game Over program, 1 simply select Run, Run Module. Then, the Interactive win- 
dow displays the results of my program. Take a look at my desktop in Figure 1.6. 


Python Shell 


1 

File Edit Shell Debug 

Optrons Windows Help 1 

. 

Python 3.1 (r31: 

73574. Jun 26 2009. 20:21:351 FHSC v. 1500 32 bit ilntelll on win32 

Type "Copyright" 

, "credits" or "licenseO" for more Information. 


Game Over 



»> 

Game Over 

»> 

-i i - 



- 


1 Ln; 8 Coh4l 




■ 


1 Ln; 2 ColTol 


Q Figurei.6 ^ 

The resuLts of 
running the Game 
Over program 
through IDLE. 


YouTl notice that the interactive window contains the old text from before. It stili has the 
statement 1 entered while in interactive mode, pri nt( "Game Over" ), and the results, the mes- 
sage Game Over. Below all of that, youTl see a restart message, and below that, the results of 
running the program from script mode: Game Over. 

To run your program from IDLE, you need to first save your program. 

Interactive mode is great for tr 5 dng out a small idea quickly. Script mode is perfect for writing 
programs you can run later. Using both modes together is a great way to code. 
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Even though I need only script mode to write a program, I always keep an Interactive window 
open. As I write my programs in script mode, I jump over to the interactive window to try out 
an idea or to be sure I have the usage of a function just right. 

The script window is where I craft my final product. The interactive window is like a scratch 
pad where I can experiment. Using them together helps me to write better programs more 
quicldy. 

Back to THE Game Over Program 

So far, you’ve run a version of the Game Over program through IDLE. While you’re in the 
process of writing a program, running it through IDLE is a fine way to go. But Em sure you 
want your finished products to work like any other program on your computer. You want a 
User to simply double-click your program’s icon to launch your program. 

If you were to try to run the version of the Game Over program Eve shovm so far in this way, 
you’d see a window appear and, just as quicldy, disappear. You’d probably think that nothing 
happened. But something wouid have happened. It just would have happened too fast for you 
to notice. The program would run, Game Over would be displayed, and the program would 
end, all in a split second. What the program needs is a way to keep its console window open. 

This updated version of Game Over, the final chapter project, keeps the program window 
open so the user can see the message. After displaying Game Over, the program also displays 
the message Press the enter key to exi t. Once a user presses the Enter key, the program 
exits, and the console window disappears. 

Eli walk you through the code one section at a time. You can load the program from the 
companion website (www.courseptr.com/downloads), in the Chapter 1 folder; the file name 
is game_over.py. Better yet, type in the program yourself and run it. 

Under the Windows operating system, you can directLy open a Python program 
in IDLE by right-cLicking on the file icon and seLecting Edit with IDLE. 


Using Comments 

The following are the first two lines of the program: 

# Game Over 

# Demonstrates the print function 

These lines aren’t statements for the computer to execute. In fact, the computer totally 
ignores them. These notes, called comments, are for the humans. Comments explain program¬ 
ming code in English (or any other language for that matter). Comments are invaluable to 
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other programmers and help them to understand your code. But comments are also helpfiil 
to you. They remind you of how you accomplished something that may not be ciear at first 
glance. 

You create a comment with the number sign symbol, #. Anything after this symbol (except in 
a string) on the rest of the line is a comment. Comments are ignored hy the computer. Notice 
that comments are colored red in IDLE to make them stand out. 

lt’s a good idea to start all of your programs with a few comments, like 1 did here. lt’s helpful 
to list the title of the program and its purpose. Although 1 didn’t do so here, you should also 
list the name of the programmer and the date the program was written. 

You may be thinking: “Why have comments at all? 1 wrote the program, so 1 know what it 
does.” That may he true a month after you write your code, hut experienced programmers 
know that after a few months away from a program, your original intentions may not be as 
ciear. If you want to modify an old program, a few well-placed comments may make your life 
much easier. 


/ \ 

In THE Real World 

Comments are even more helpful to another programmer who needs to modify a 
program you wrote. This kind of situation comes up a lot in the world of professional 
programming. In fact, lt's estimated that the majority of a programmer's time and 
effort go toward maintaining code that already exists. It's not uncommon for a pro¬ 
grammer to be charged with the task of modifying a program written by someone 
else—and there's a chance that the original programmer won't be around to answer 
any questions. So, good comments are critical. 


Using Blank Lines 

Technically, the next line in the program is hlank. The computer generally ignores hlank 
lines; these, too, are just for the humans reading the code. Blank lines can make programs 
easier to read. Usually, 1 keep lines of related code together and separate sections with a blank 
line. In this program, 1 separated the comments from the call to the pri nt function with a 
blank line. 

Printing the String 

The next line in the program should seem familiar to you: 
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printCGame Over") 

It’s your old friend, the pri nt function. This line, just as it does in interactive mode, displays 
Game Over. 

Waiting for the User 

The last line of the program 

input( "\n\nPress the enter key to exit.") 

displays the prompt, Press the enter key to exi t, and waits for the user to press the Enter 
key. Once the user presses the key, the program ends. This is a nice trick to keep a console 
window open until the user is done with an application. 

Normally, this is ahout the time Fd explain just what is going on in this line. But Fm going 
to keep you in suspense. Sorry. You’11 have to wait until the next chapter to fully appreciate 
this one line. 

SUMMARY 

You covered a lot of ground in this chapter. You learned a bit ahout Python and its strengths. 
You installed the language on your computer and gave it a little test drive. You learned to use 
Python’s interactive mode to instantly execute a programming statement. You saw how to 
use script mode to write, edit, save, and run longer programs. You learned how to display text 
to the screen and how to wait for the user before closing a program’s console window. You 
laid all the groundwork necessary for your adventure in Python programming. 


* ' 

Challenges 

1. Create an error of your very own by entering your favorite ice 
cream flavor in interactive mode. Then, make up for your 
misdeed and enter a statement that prints the name of your 
favorite ice cream. 

2. Write and save a program that prints out your name and waits 
for the user to press the Enter key before the program ends. 
Then, run the program by double-clicking its icon. 

3. Write a program that prints your favorite quote. It should give 
credit to the person who said it on the next line. 
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Types, Variables, and 
Simple I/O: The Useless 
Trivia Program 


N ow that you’ve been introduced to the basies of saving and exeeuting a 
program, it’s time to dig in and create some more. In this chapter, you’11 
learn about different ways computers can categorize and store data and, 
more importantly, how to use this data in your programs. You’11 even see how to 
get Information from the user so that your programs become interactive. Specifi- 
cally, you’11 learn how to do the following; 

• Use triple-quoted strings and escape sequences to gain more control over text 
• Make your programs do math 
• Store data in the computer’s memory 
• Use variables to access and manipulate that data 
• Get input from users to create interactive programs 

InTRODUCING THE USELESS TrIVIA PrOGRAM 

Combining the sldlls presented in this chapter, you’11 create the Useless Trivia 
program shown running in Figure 2.1. 
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Whoa! Steve 
might think about 
a diet before he 
visits the sun. 


C:\Python31\python.exe 




Hi. U}iat's your name? Steve 
How old are you? 28 

Okay, last question. How many pounds do you weigh? 165 


If poet ee cummings were to email you, he'd address you as steve 
[Hiit if ee were mad, he'd call you STEUE 


If a small child were trying to get your attention 
vvur name would become: 

[SteveSteveSteveSteveSteve 


IVou^re over 883008000 seconds old. 


Did you know that on the moon you would weigh onlv 27.5 pounds? 
On the sun, you^d weigh 4471.5 <but, ah... not for long>. 


Press the enter key to exit._ 


The program takes three pieces of personal information from the user: name, age, and weight. 
From these mundane items, the program is able to produce some amusing but trivial facts 
about the person, such as how much the person would weigh on the moon. 

Though this may seem like a simple program (and it is), you’11 find that the program is more 
interesting when you run it because you’ve had input. You’11 care more about the results 
because they’re personally tailored to you. This holds true for all programs, from games to 
business applications. 

UsiNG Quotes with Strings 

You saw an example of a string, "Game Over", in the previous chapter. But strings canbecome 
much longer and more complex. You may want to give a user several paragraphs of instruc- 
tions. Or you might want to format your text in a very specific manner. Using quotes can help 
you to create strings to accomplish all of this. 

Introducing the Game Over 2.0 Program 

Game Over 2.0 improves upon its predecessor program, Game Over, by displaying a more 
impressive version of the same message, which telis a player that his or her computer game 
has come to an end. Check out Figure 2.2 to see a sample run. 
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Q F|GURE2.2 ^ 

Now I get it, the 
game is over. 


The program shows that it’s pretty simple to present text in different ways by using quotes. 
You can find the code for this program on the companion website (www.courseptr.com/ 
downloads) for this book, in the Chapter 2 folder; the file name is game_over2.py. 

# Game Over - Version 2 

# Demonstrates the use of quotes in strings 

printCProgram 'Game Over' 2.0") 

print("Same", "message", "as before") 

printCJust", 

"a bit", 

"bigger") 

printCHere", end=" ") 
printCit is...") 


print( 























Python Programming for the Absolute Beginner, Third Edition 



/ 

_1 

/ 1 

/ l/ II _ 

1 

1 

/ /l 1 

/ /l /Illi- 

1 

1 - 

/_ 1 

/ / I-/ 1 1 1 -1 

1 

l-l 1 

/ / 1 1 

II IMI— 

\ 

/ 

II II 

II III 





/ 

\ 

II II 

1 —1 1 - \ 

1 

1 1 1 

1 1 / / 

1 1- 1 l-l 1 

1 

1 1 1 

1 1 / / 

l-l 1 - / 

1 

l-l 1 

1 l/ / 

II— 1 1 \ \ 

\ 

/ 

1_/ 

1 1 1 1 \ \ 


II II II 

) 

input( "\n\nPress the enter key to exit.") 

Using Quotes Inside Strings 

YouVe seen how to create simple strings by surrounding text with quotes. You can use either 
a pair of single (' ') or double quotes ("") to create string values. The computer doesn’t care. 
So, 'Game Over' represents the same string as "Game Over". But take a look at the first appear- 
ance of a string in the program: 

print "Program 'Game Over' 2.0" 

This statement uses hoth Idnds of quotes. Check out the sample run in Figure 2.2 again. Only 
the single quotes show up, because they are part of the string, just like, for example, the letter 
G. But the double quotes are not part of the string. The double quotes are like bookends, telling 
the computer where the string begins and ends. So, if you use a pair of douhle quotes to 
“bookend” your string, you can use as many single quotes inside the string as you want. And, 
if you surround your string with a pair of single quotes, you can use as many double quotes 
inside the string as you like. 

Once youVe used one kind of quote as bookends for your string, you can’t use that type of 
quote inside your string. This make sense, hecause once the computer sees the second appear- 
ance of the quote that began the string, it thinks the string is over. For example, "With the 
words, 'Houston, we have a problem.', Jim Lovell became one of our most famous astro- 
nauts ." is a valid string. But, "With the words, "Houston, we have a problem.", Jim Lovell 
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became one of our most famous astronauts isn’tvalid, because once the computer sees the 
second double quote, it thinks the string is over. So, the computer sees the string "Wi th the 
words ," followed by the word, Houston. And since the computer has no idea what Houston is, 
you’d get a nasty error in your program. 

Printing Multiple Values 

You can print multiple values with a single call to the print( ) function—just list multiple 
argument values, separated by commas. 1 print multiple values with the line 

print("Same", "message", "as before") 

1 pass three arguments to the function: "Same", "message", and "as before .", which results in 
the code displaying Same message as before. Notice that each value is printed with a space as 
a separator. This is the default behavior of the print( ) function. 

When you have a list of arguments, you can start a new line after any of the comma separators 
in the list. The next three lines of the program form a single statement that prints the one 
line of text Just a bit bi gger. 1 start a new line after each comma separator: 

print ("Just", 

"a bit", 

"bigger") 

Sometimes it’s useful to break up an argument list over multiple lines because it can make 
your code easier to read. 

Specifying a Final String to Print 

By default, the pri nt( ) function prints a newline character as a final value. This means that 
a subsequent call to print () would display text on the following line. This is generally what 
you want, but you have the ability specify your own final string to be printed. You could, for 
example, specify that a space be the final character printed (instead of the newline) when you 
call the printO function. This would mean a subsequent printO statement would begin 
printing values right after that space. 1 take advantage of this functionality in the next two 
lines of the program: 

print("Here". end=" ") 
print("it is...") 

The code prints the text “Here it is...” all on one line. Thafs because, in the first print() 
statement, 1 specify a space to be the final string to be printed. So, the statement prints the 
text “Here ” (including a space after the final “e”) but no newline character. The next 
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pri nt( ) statement begins printing the text “it is...” right after the space that follows the final 
“e” in the “Here” text. I accomplish this by passing a space to the end parameter of the 
pri nt( ) flinction with the code end='' ". You can specify a string to be printed as the final 
value inyour own pri nt( ) statement, justlikel did: with a comma, followed by the parameter 
name end, followed by an equals sign, followed by fhe final sfring fo be printed. Being able to 
specify your own final string to be printed in a pri nt( ) statement gives you greater flexibility 
in how you format your output. 

Don’t worry if you don't know what a parameter is justyet. YoulL Learn aLL about 
parameters and passing vaLues to them in Chapter 6, in the "Using Parameters 
and Return VaLues" section. 



Creating TripLe-Quoted Strings 

Certainly, the coolest part of the program is that it prints out “Game Over” in a big block of 
text. The following string is responsible: 
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This is whafs called a triple-quoted string. lt’s a string enclosed by a pair of three quotes in a 
row. Like before, it doesnT matter which kind of quotes you use, as long as you bookend with 
the same type. 

As you can see, triple-quoted strings can span multiple lines. They print on the screen exactly 
the way you t 5 q)e them. 
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In THE Real World 

If you like the letters made from multiple characters in Game Over 2.0, then you'll 
really like ASCIIArt. ASCII Art is basically pictures made from just the characters on 
your keyboard. ASCII, by the way, stands for the American Standard Code for Infor¬ 
mation Interchange. It'sa codethat represents 128 Standard characters. (This kind of 
art isn't new, and it didn't start with the computer. In fact, the first recorded type- 
writer art dates back to I 898.) 


UsiNG Escape Sequences with Strings 

Escape sequences allow you to put special characters into your strings. They give you greater 
control and flexibility over the text you display. The escape sequences youTl work with are 
made up of two characters: a hackslash followed hy another character. This may all sound a 
little mysterious, hut once you see a few sequences in action, you’ll realize just how easy they 
are to use. 

Introducing the Fancy Credits Program 

Besides telling a player that the game is over, a program often displays credits, a list of all the 
people who worked so hard to make it a reality. Fancy Credits uses escape sequences to achieve 
some effects it just couldnT without them. Figure 2.3 shows the results. 



Q F1GURE2.3 ^ 

PLease, contain 
your appLause. 
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The code looks a bit cryptic at first glance, but you’11 soon understand it all. You can find the 
code for this program on the companion website (courseptr.com/downloads) for this book, in 
the Chapter 2 folder; the file name is fancy_credits.py. 

# Fancy Credits 

# Demonstrates escape sequences 

print( "\t\t\tFancy Credits") 

print("\t\t\t W W W W W W W") 
print( "\t\t\t\tby" ) 
print( "\t\t\tMi chael Dawson") 
print("\t\t\t W W W W W W W") 

print( "\nSpecial thanks goes out to:") 

printCMy hair stylist, Henry \'The Great,\' who never says \"can\'t.\'"') 

# sound the system bel1 
print("\a") 

input( "\n\nPress the enter key to exit.") 

Moving Forward a Tab Stop 

Sometimes you’11 want to set some text off from the left margin where it normally prints. In 
a Word processor, you could use the Tab key. With strings, you can use the escape sequence 
for a tab, \ t. Thafs exactly what 1 did in the following line: 

print( "\t\t\tFancy Credits") 

1 used the tab escape sequence, \t, three times in a row. So, when the program prints the 
string, it prints three tabs and then Fancy Credits. This makes Fancy Credits look nearly 
centered in the console window. Tab sequences are good for setting off text, as in this pro¬ 
gram, but they’re also perfect for arranging text into columns. 

Printing a Backslash 

lfyou’ve thought ahead, you may be wondering howyou can print a backslash if the computer 
always interprets a backslash as the beginning of an escape sequence. Well, the solution is 
pretty simple: just use two backslashes in a row. Each of the following lines prints three tabs 
followed by seven backslashes (as a resuit of the seven W sequences), separated by spaces: 
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print(''\t\t\t W W W W W W W") 
print(''\t\t\t W W W W W W W") 

Insertinga Newline 

One of the most useful sequences at your disposal is the newline sequence. It’s represented 
by \n. By using this sequence, you can insert a newline character into your strings for a blank 
line where you need it. You can use a newline right at the beginning of a string to separate 
it from the text last printed. Thafs what 1 did in the line; 

print( ''\nSpecial thanks goes out to:") 

The computer sees the \n sequence, prints a blank line, then prints Speci al thanks goes out 
to:. 

Inserting a Quote 

Inserting a quote into a string, even the t 5 q)e of quote you use to bookend it, is simple. Just 
use the sequence \' for a single quote and \" for a double quote. They mean “put a quote 
here,” and won’t be mistaken by the computer as a marker for the end of your string. This is 
what 1 used to get hoth kinds of quotes in one line of text: 

printCMy hair stylist, Henry \'The Great,\' who never says \"can\'t.\"") 

The pair of double quotes at both ends are the bookends, defining the string. To make the 
string easier to understand, look at it in parts: 

• \'The Great\' prints as 'The Great' 

• Each \' sequence is printed as a single quote 

• \"can\'t\" prints as ''can't'' 

• Both \" sequences print as double quotes 

• The Ione \' sequence prints as a single quote 

Sounding the System Bell 

Upon running this program, youTl notice something different right away. It makes noise! The 
next statement in the program 

print("Xa") 

sounds the system bell ofyour computer. It does this through the escape sequence, \a, which 
represents the system bell character. Every time you print it, the bell rings. You can print a 
string with just this sequence, as 1 have, or you can put it inside a longer string. You can even 
use the sequence several times to ring the hell more than once. 
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A few escape sequences only work as advertised if you run your program directly from the 
operating system and not through IDLE. The escape sequence \a is a good example. Let’s say 
I have a program that simply prints the escape sequence \a. If I run it through IDLE, I get a 
littie square box printed on my screen—not what I wanted. But if I run that same program 
directly from Windows, by double-clicking the program file icon, my computer’s system bell 
rings just as I intended. 

As you can see, escape sequences aren’t so bad once you’ve seen them in action. And they can 
come in quite handy. Table 2.1 summarizes some useful ones. 



CONCATENATING AND RePEATING StRINGS 

YouVe seen how you can insert speciai characters into a string, but there are things you can 
do with entire strings themselves. You can combine two separate strings into a larger one. 
And you can even repeat a singie string as many times as you like. 

Introducing the Silly Strings Program 

The Silly Strings program prints several strings to the screen. The results are shown in 
Eigure 2.4. 

Though you’ve aiready seen strings printed, the way these strings were created is brand-new 
to you. You can find the code for this program on the companion website 
(www.courseptr.com/downIoads) for this book, in the Chapter 2 folder; the file name is 
silly_strings.py. 
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X 



The stnngs on the 
screen appear 
differentLy than in 
the program code. 


# Si 1ly Strings 

# Demonstrates string concatenatiori and repetition 

printCYou can concatenate two " + "strings with the '+' operator.") 

print( ''\nThi s string " + "may not " + "seem terr" + "ibly impressive. " \ 

+ "But what " + "you don't know" + " is that\n" + "it's one real" \ 

+ + "y” + " ]ong string, created from the concatenatior " \ 

+ "of " + "twenty-twoXn" + "different strings, broken across " \ 

+ "six lines." + " Now are you" + " impressed? " + "Okay,\n" \ 

+ "this " + "one " + "long" + " string is now over!") 

print(''\nlf you really like a string, you can repeat it. For example,") 
printCwho doesn't like pie? Thafs right, nobody. But if you really") 
print("like it, you should say it like you mean it:") 
printCPie" * 10) 

input("\n\nPress the enter key to exit.") 

Concatenating Strings 

Concatenating strings means joining them together to create a whole new string. A simple 
example is in the first pri nt statement: 

printCYou can concatenate two " + "strings with the '+' operator.") 
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The + operator joins the two strings, "You can concatenate two " and "strings with the ' + ' 
operator.", together to form a new, larger string. It’s pretty intuitive. It’s like adding the 
strings together using the same symbol youVe always used for adding numhers. 

When you join two strings, their exact values are fused together, with no space or separator 
character inserted between them. So, if you were to join the two strings "cup" and "cake", 
you’d end up with "cupcake" and not "cup cake". In most cases, you’11 want to insert a space 
between strings you join, so don’t forget to put one in. 

The next print statement shows thatyou can concatenate ‘til your hearfs content: 

print( "\nThi s string " + "may not " + "seem terr" + "ibly impressive. " \ 

+ "But what " + "you don't know" + " is that\n" + "it's one real" \ 

+ + "y" + " ]ong string, created from the concatenation " \ 

+ "of " + ''twenty-two\n" + "different strings, broken across " \ 

+ "six lines." + " Now are you" + " impressed? " + "Okay,\n" \ 

+ "this " + "one " + "long" + " string is now over!") 

The computer prints one long string that was created by the concatenation of 22 individual 
strings. 

Using the Line Continuation Character 

Generally, you write one statement per line. But you don’t have to. You can stretch a single 
statement across multiple lines. All you have to do is use the line-continuation character, \ 
(which is just a backslash), as I did in the preceding code. Put it anywhere you’d normally use 
a space (but not inside a string) to continue your statement on the next line. The computer 
will act as if it sees one long line of code. 

The computer doesnT care how long a programming line is, but people do. If a line of your 
code feels too long, or would be more ciear as several lines, use the line-continuation character 
to split it up. 

Repeating Strings 

The next new idea presented in the program is illustrated in the following line: 
printCPie" * 10) 

This line creates a new string, " P i e P i e P i e P i e P i e P i e P i e P i e P i e P i e", and prints it out. Thafs the 
string "Pie" repeated 10 times, by the way. 

Like the concatenation operator, the repetition operator, *, is pretty intuitive. It’s the same 
s 5 mibol used for multiplying numhers on a computer, so repeating a string with it makes 
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sense. It’s like you’re multiplying the string. To repeat a string, just put the string and number 
of repetitions together with the repetition operator, *. 

WORKING WITH NUMBERS 

So far, you’ve been using strings to represent text. Thafs just one type of value. Computers 
let you represent information in other ways, too. One of the most hasic but most important 
ways is as numbers. Numbers are used in almost every program. Whether you’re writing a 
space shooter game or horne finance package, you need to represent numbers some way. 
YouVe got high scores or checking account balances to work with, after ali. Fortunately, 
Python has several different t 5 ^es of numbers to fit ali of your game or application program- 
ming needs. 

Introducing the Word Problems Program 

This next program uses those dreaded word problems. You know, the kind that always seems 
to involve two trains leaving different cities at the same time headed toward each other... 
bringing hack nightmares of junior high algebra as they’re about to collide. Well, fear not. 
You won’t have to solve a single word problem, or even do any math at ali—the computer will 
do ali the work. The Word Problems program is just an amusing (hopefully) way to explore 
working with numbers. Check out Figure 2.5 to see a sample run. 


C:\Python31\python.exe HEID 

|If a pound pt*egnant hippo gives birtli to a pound calf, 

hut then eats 50 pounds of food, how nuch does she weigh? 

Press the enter key to find out. 

^2000 - 100 + 50 = 1950 

jlf an adventarer returns from a successful quest and buvs each of 
companions 3 bottles of ale, how manv bottles are purchased? 

Press the enter key to find out. 

6 3 = 18 

If a restaurant check comes to 19 dollars with tip, and and 

'vour friends split it evenly 4 ways, how much do you each throw in? 

Press the enter key to find out. 
jl9 / 4 = 4.75 

If a group of 4 pirates finds a chest full of 107 gold coins, and 
|they divide the booty evenly, how many whole coins does each get? 

Press the enter key to find out. 

107 // 4 = 26 

If that same group of 4 pirates evenly divides the chest full 
of 107 gold coins, how many coins are left over? 

Press the enter key to find out. 

107 X 4 = 3 


Press the enter key to exit.. 

I_ I _ i 


Q Figure 2.5 3 

With Python, you 
can add, subtract, 
muLtipLy, divide, 
and keeptrackof a 
pregnant hippo's 
weight. 


You can find the code for this program on the companion website (www.courseptr.com/ 
downloads) for this book, in the Chapter 2 folder; the file name is word_problems.py. 








© 


Python Programming for the Absolute Beginner, Third Edition 


# Word Probiems 

# Demonstrates numbers and math 

printCIf a 2000 pound pregnant hippo gives birth to a 100 pound calf,") 
printCbut then eats 50 pounds of food, how much does she weigh?") 
inputCPress the enter key to find out.") 
print("2000 - 100 + 50 =". 2000 - 100 + 50) 

print("\nlf an adventurer returns from a successful quest and buys each 
cr of") 

print("6 cotnpanions 3 bottles of ale, how many bottles are purchased?") 
inputCPress the enter key to find out.") 
print("6*3=", 6*3) 

print("\nlf a restaurant check comes to 19 dollars with tip, and you and") 
printCyour friends split it evenly 4 ways, how much do you each throw 
cr in?") 

inputCPress the enter key to find out.") 
print("19 / 4 =", 19 / 4) 

print("\nlf a group of 4 pirates finds a chest full of 107 gold coins, “P 
cr and") 

printCthey divide the booty evenly, how many whole coins does each get?") 
inputCPress the enter key to find out.") 
print("107 // 4 =". 107 // 4) 

print("\nlf that same group of 4 pirates evenly divides the chest full") 
printCof 107 gold coins, how many coins are left over?") 
inputCPress the enter key to find out.") 
print("107 % 4 =", 107 % 4) 

input( "\n\nPress the enter key to exit.") 

Understanding Numeric Types 

The program Word Problems uses numbers. Thafs obvious. But what may not be obvious is 
that it uses two different types of numbers. Python allows programmers to use several dif¬ 
ferent types of numbers. The two types used in this program, and probably the most common, 
are integers and floating-point numbers (or floats). Integers are whole numbers—numbers with 


Chapter2 • Types, Variables, and Simple 1/0: The Useless Trivia Program 


© 


no fractional part. Or, another way to think about them is that they can be written without 
a decimal point. The numbers 1,27, -100, and 0 are all examples ofintegers. Floats are numbers 
with a decimal point, like 2.376, -99.1, and 1.0. 

Using MathematicaL Operators 

With mathematical operators, you can turn your computer into an expensive calculator. The 
operators should look pretty familiar. For example, the code 2000 - 100 + 50 subtracts 100 
from 2000 and then adds 50 before printing the resuit of 1950. Technically, it evaluates the 
expression 2000 - 100 -i- 50, which evaluates to 1950. An expression is just a sequence ofvalues, 
joined by operators, that can be simplified to another value. The code 6*3 multiplies 6 by 
3 and prints the resuit of 18. And the code 19/4 divides 19 by 4 and prints the floating-point 
resuit of 4.75. 

So far, all of these mathematical operators should be pretty familiar—but check out the next 
calculation, 107 // 4. Using // as a mathematical operator is probably new to you. Used 
here, // (two forward slashes) represents integer division—division where the resuit is always 
an integer (any fractional part is ignored). This is opposed to true division, which you just saw 
with the / operator (where the fractional part of the resuit is not ignored). So, the resuit of 
107 // 4 is 26. 

The next calculation, 107 % 4, might also make you scratch your head. Used here, the symbol 
% is the modulus operator, which produces the remainder of an integer division expression. So 
107 % 4 evaluates to 3, the remainder of 107 / 4. 

Table 2.2 summarizes some useful mathematical operators. 


Table 2.2 Useful Mathematical Operators 


Operator 

Descriptiori 

Example 

Evaluates To 

-1- 

Addition 

7 + 3 

10 

- 

Subtraction 

7 - 3 

4 

* 

MuLtipLication 

7 * 3 

21 

/ 

Division (True) 

7/3 

2.3333333333333335 

// 

Division (Integer) 

7 // 3 

2 

% 

Modulus 

7 % 3 

1 
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Notice the true division entry in Table 2.2. It says that 7 divided by 3 is 2.3333333333333335. 
While this is pretty accurate, it’s not exact. The results are fine for most purposes, but you 
should be aware of this when using floats. 

The decima 1 module provides support for accurate decimat floating-point arith- 
metic. To Learn more, see the Python documentation. 



Understanding Variables 

Through variables, you can store and manipulate information, a fundamental aspect of pro¬ 
gramming. Python lets you create variables to organize and access this information. 


Introducing the Greeter Program 

Check out Figure 2.6 to see the results of the Greeter program. 


Q Figure2.6 ^ 

A shout-out to aLL 
the Larry's of the 
worLd. 


C:\Python31\python.exe 


Lai*i*y 
Hi, Lai*i*v 


Press the entei» key to exit._ 


Hil 


From just the screen shot in Figure 2.6, this program looks like something you could have 
already written. But within the code lurks the new and powerful concept of variables. You 
can find the code for this program on the companion website (www.courseptr.com/down- 
loads) for this book, in the Chapter 2 folder; the file name is greeter.py. 

# Greeter 

# Demonstrates the use of a variable 
name = "Larry" 
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pri nt(naine) 
print("Hi,", name) 


input("\n\nPress the enter key to exit.") 


Creating Variables 

Avariable provides a way to label and access information. Instead of having to know exactly 
where in the computer’s memory some information is stored, you use a variable to get at it. 
It’s kind of like calling your friend on his cell phone. You don’t have to know where in the 
City your friend is to reach him. You just press a button and you get him. But, before you use 
a variable, you have to create it, as in the following line: 

name = "Larry" 

This line is called an assignmentstatement. It creates avariable called name and assigns it avalue 
so that it references the string " La r ry ". In general, assignment statements assign a value to a 
variable. If the variable doesn’t already exist, as was the case with name, it’s created, then 
assigned a value. 



TechnicaLLy, an assignment statement Stores the vaLue on the right side of the 
equaL sign in your computer's memory whiLe the variable on the Left side onLy 
refersto the value (and doesn'tdirectlystore it).Therefore, Python puristswould 
say that a variable "gets" a value instead of saying that a variable is "assigned" a 
value. However, I use "gets" and "assigned" interchangeably, depending upon 
which seems clearest. 

You’11 learn more about the implications of the way variables refer to values 
(rather than storing them) in Chapter 5, in the section "Understanding Shared 
References." 


Using Variables 

Once a variable has been created, it refers to some value. The convenience of a variable is that 
it can be used just like the value to which it refers. So the line 

print(name) 

prints the string " La r ry " just like the statement p r i nt (" La r ry ") does. And the line 
print("Hi,", name) 

prints the string "Hi ," followed hy a space, followed by "Larry". In this case, I can use name 
instead of "Larry" with the same results. 
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Naming Variables 

Like the proud parent ofyour program, you pick the names ofyour variahles. For this program, 
I chose to call my variahle name, hut I could just as easily have used person, guy, or 
alpha7345690876, and the program would have run exactly the same .There are only a few rules 
that you have to follow to create legal variahle names. Create an illegal one and Python will 
let you Icnow ahout it with an error. The following are the two most important rules: 

1. A variahle name can contain only numbers, letters, and underscores. 

2. A variahle name can’t start with a number. 

In addition to the rules for creating legal variahle names, the following are some guidelines 
that more experienced programmers follow for creating good variahle names—because, once 
youVe programmed for a while, you loiow the chasm of difference that exists between a legal 
variahle name and a good one. (ITl give you one guideline right now: Don’t ever name a 
variahle alpha7345690876.) 

• Choose descriptive names. Variahle names should be ciear enough so that another 
programmer could look at the name and have a good idea what it represents. So, for 
example, use score instead of s. (One exception to this rule involves variables used for a 
brief period. Often, programmers give those variables short names, like x. But thafs fine, 
because by using x, the programmer clearly conveys the variahle represents a quick 
holding place.) 

• Be consistent. There are different schools of thought ahout how to write multiword 
variahle names. Is it high_score or highScore? 1 use the underscore style. But it’s not 
important which method you use, as long as you’re consistent. 

• Follow the traditions of the language. Some naming conventions are just traditions. 
For example, in most languages (Python included) variahle names start with a lowercase 
letter. Tfiiother tradition is to avoid using an underscore as the first character of your 
variahle names. Names that begin with an underscore have special meaning in Python. 

• Keep the length in check. This may seem to go against the first guideline: Choose de¬ 
scriptive names. lsn’t personal_checki ng_account_bal ance a great variahle name? Maybe 
not. Long variahle names can lead to problems. They can make statements hard to read. 
Plus, the longer the variahle name, the greater the chance of a typo. As a guideline, try 
to keep your variahle names under 15 characters. 



Self-documenting code is written in such a way that it's easy to understand 
what is happening in the program independent of any comments. Choosing 
good variahle names is an excellent step toward this kind of code. 
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Getting User Input 

After appreciating all that program Greeter has to offer, you may stili be thinking, “So what?” 
Yes, you could write a program that does exactly what Greeter does without going to the 
trouble of creating any fancy variables. But to do fundamentally important things, including 
getting, storing, and manipulating user input, you need variables. Gheck out the next pro¬ 
gram, which uses input to give a personalized greeting. 

Introducing the Personat Greeter Program 

The Personal Greeter program adds a single, but very cool, element to the Greeter program; 
user input. Instead of working with a predefined value, the computer lets the user enter his 
or her name and then uses it to say hi. Figure 2.7 shows off the program. 


C:\Python31\python.exe 


|Hi. U}mt's youi* nane? Riipe»»t 

iRupert 

iHi, Rupert 


jPress the entei' key to exit. 


Hil 


Q Figure 2.7 3 

Now, name is 
assigned a string 
based on whatever 
the user enters, 
including 

"Rupert". 


Getting user input isn’t very hard. As a resuit, the code doesn’t look much different. You can 
find the code for this program on the companion website (www.courseptr.com/downloads) 
for this book, in the Ghapter 2 folder; the file name is personal_greeter.py. 

# Personal Greeter 

# Demonstrates getting user input 

name = inputCHi. Whafs your name? ") 
print(name) 
print("Hi,", name) 


input(''\n\nPress the enter key to exit.") 
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Using the inputQ Function 

The only line thafs changed is the assignment statement: 
name = inputCHi. Whafs your name? ") 

The left side of the statement is exactly the same as in the Greeter program. name is created 
and a value is assigned to it, just like before. But this time, the right side of the assignment 
statement is a call to the function i nput (). The i nput () function gets some text from the user. 
It takes a string argument that it uses to prompt the user for this text. In this case, the argu- 
ment I passed to inputO is the string "Hi. Whafs your name? ". As you can see from 
Figure 2.7, i nput( ) does indeed use the string to prompt the user. i nput( ) waits for the user 
to enter something. Once the user presses the Enter key, i nput () returns whatever the user 
typed as a string. That string, the retum value of the function call, is what name gets. To help 
visualize how this works, imagine that in the assignment statement, the call to i nput( ) is 
replaced with the string the user t 3 ^ed. Now of course, the code in the program doesnT 
change, but imagining the return value of a function in place of the call to that function helps 
drive horne how you can use return values. 

If you’re stili not totally ciear on function calls, arguments, and return values, here’s another 
way to think about it: using i nput( ) is like ordering a pizza. The i nput( ) function is like a 
pizza parior. You make a call to a pizza parior to place your order, and you make a call to the 
i nput () function to kickit into gear. Whenyou call the pizza parior, you provide information, 
like “pepperoni.” When you call the i nput 0 function, you pass it an argument like, 
"Hi. Whafs your name?". After you finish your call to the pizza parior, the employees get a 
pepperoni pizza to your door. And after you make your call to i nput( ), the function returns 
whatever string the user entered. 

The rest of the Personal Greeter program works just like the Greeter program. It makes no 
difference to the computer how name gets its value. So the line 

print(name) 

prints the value of name. While the line 
printCHi,", name) 

displays the string "Hi ," followed by a space, followed by the value of name. 

At this point, you know enough to understand the last line in all of these console programs. 
The goal of the last line is to wait for the user to press the Enter key: 

input( "\n\nPress the enter key to exit.") 
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It does exactly that through the i nput () function. Since I don’t care what the user enters, so 
long as he or she presses the Enter key, I don’t assign the return value of i nput () to a variahle 
like before. It may seem weird to get a return value and do nothing with it, hut it’s my option. 
If I don’t assign the return value to a variahle, the computer just ignores it. So once the user 
presses the Enter key, the call to the i nput () function ends, the program ends, and the console 
window closes. 

UsiNG String Methods 

Python has a rich set of tools for working with strings. One type of these tools is string meth¬ 
ods. String methods allow you to create new strings from old ones. You can do everything 
from the simple, such as create a string thafs just an all-capital-Ietters version of the original, 
to the complex, such as create a new string thafs the resuit of a series of intricate letter 
suhstitutions. 

Introducing the Quotation ManipuLation Program 

According to Mark Twain, “The art of prophecy is very difficult, especially with respect to the 
future.” While if s hard to accurately foretell the future, if s stili amusing to read predictions 
that pundits have made about technology. A good one is, ‘T think there is a world market for 
maybe five computers.” This was made by then IBM chairman, Thomas Watson, in 1943. The 
Quotation Manipulation program that I wrote prints this quote several ways using string 
methods. (Eortunately, I was able to write this program because I happen to own computer 
#3.) Take a look at the sample run in Eigure 2.8. 


| |c^ C:\Python31\python.exe 


[Original quote: 

I think there is a world market for maybe fioe computers. 


In uppercase: 

I THINK THERE IS R WORLD MRRKET FOR tlRySE FIUE COMPUTERS. 


In lowercase: 

i think there is a world market for maybe fiue computers. 


Rs a title: 

I Think There Is R World Market For Maybe Five Computers. 


[VIith a minor replacement: 

I think there is a world market for maybe millions of computers. 


[Original quote is stili: 

I think there is a world market for maybe five computers. 


Press the enter key to exit._ 


HEID 



This sLightLy Low 
guess is printed 
severaL ways with 
the heLp of string 
methods. 
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You can find the code for this program on the book’s companion website (www.courseptr.com/ 
downloads), in the Chapter 2 folder; the file name is quotation_manipulation.py. 

# Quotation Manipulation 

# Demonstrates string methods 

# quote from IBM Chairman, Thomas Watson, in 1943 

quote = "I think there is a world market for maybe five computers." 

printi"Original quote:") 
print(quote) 

print("\nln uppercase:") 
printiquote.upperi)) 

print("\nln lowercase:") 
printiquote.1ower()) 

print("\nAs a title:") 
printlquote.titleO) 

print("\nWith a minor replacement:") 
printiquote.repiace("five", "millions of")) 

print("\nOriginal quote is stili:") 
print(quote) 

inputl "\n\nPress the enter key to exit.") 

Creating New Strings with String Methods 

Though there’s a new concept at work here, the code is stili pretty understandable. Take a 
look at the line: 

printlquote.upperO) 

You can probably guess what it does: print a version of quote in all uppercase letters. The line 
does this through the use of a string method, upper () .Astring method is like an ability a string 
has. So, quote has the ability to create a new string, a capitalized version of itself, through its 
upper () method. When it does this, it returns this new string, and the line becomes equivalent 
to the following line: 
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printCI THINK THERE IS A WORLD MARKET FOR MAYBE EIVE COMPUTERS.") 

Now, the line of code is never like this, but you can think of it in this way to help you under- 
stand how the method works. 

YouVe probably noticed the parentheses in this method call. It should remind you of fnnc- 
tions. Methods are similar to fimctions. The main difference is that a built-in fnnction, like 
input( ), can be called on its own. But a string method has to be called through a particular 
string. It makes no sense to just type the following: 

print(upper()) 

You kick off a method, or invoke it, by adding a dot, followed by the name of the method, 
followed by a pair of parentheses, after a string value. The parentheses aren’t just for show. 
As with functions, you can pass arguments inside them. upper( ) doesn’t take any arguments, 
but youTl see an example of a string method that does with repi ace (). 

The line 

print(quote.lower()) 

invokes the 1 ower( ) method of quote to create an allTowercase-letters version of the string, 
which the method returns. Then, that new, lowercase string is printed. 

The line 

printiquote.title()) 

prints a version of quote thafs like a title. The ti tl e( ) method returns a stringwhere the first 
letter of each word is capitalized and the rest of the string is in lowercase. 

The line 

printiquote.repiace("five", "millions of")) 

prints a new string, where every occurrence of "five" in quote is replaced with "millions 
of". 

The method repi ace( ) needs at least two pieces of information: the old text to be replaced, 
and the new text that replaces it. You separate the two arguments with a comma. You can 
add an optional third argument, an integer, that telis the method the maximum number of 
times to make the replacement. 

Finally, the program prints quote again, with 

print( "\nOriginal quote is stili:") 
print(quote) 


© 


Python Programming for the Absolute Beginner, Third Edition 


You can see from Figure 2.8 that quote hasn’t changed. Remember, string methods create a 
new string. They don’t affect the original one. Table 2.3 summarizes the string methods you’ve 
just seen, along with a few others. 


Table 2.3 Useful String Methods 


Method 

upper() 
lower() 
swapcase() 

capitalizeO 

title() 

strip() 

replace(o7c/, nev [.ntax]) 


Description 

Returns the uppercase version of the string. 

Returns the Lowercase version of the string. 

Returns a new string where the case of each Letter is switched. 
Uppercase becomes lowercase and lowercase becomes uppercase. 
Returns a new string where the first letter is capitaLized and the rest 
are Lowercase. 

Returns a new string where the first Letter of each word is capitaLized 
and aLL others are Lowercase. 

Returns a string where aLL the white space (tabs, spaces, and newLines) 
at the beginning and end is removed. 

Returns a string where occurrencesof the string 0 7 c/are repLaced with 
the string new. The optionaL mdX Limits the number of repLacements. 


USING THE RiGHT TyPES 

YouVe used three different types so far: strings, integers, and floating-point numbers. It’s 
important to know not only which data types are available to you, but how to work with them. 
If you don’t, you might end up with programs that produce unintended results. 

Introducing the Trust Fund Buddy—Bad Program 

The idea for the next program was to create a tool for those sonis who play ali day, living off 
a generous trust fund. The program is supposed to calculate a grand total for monthly expen- 
ditures based on user input. This grand total is meant to help those living beyond any 
reasonable means to stay within budget so they don’t ever have to think about getting a real 
job. But, as you may have guessed from the program’s title, Trust Fund Buddy—Bad doesn’t 
work as the programmer intended. Figure 2.9 shows a sample run. 
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Q F|GURE2.9 ^ 

The monthLy totaL 
shouLd be high, but 
not that high. 
Something Is 
wrong. 


All right, the program obviously isn’t working correctly. It has a bug. But not a bug that causes 
it to crash. When a program produces unintended results but doesn’t crash, it has a logical 
error. Based on what you already Icnow, you might be able to figure out whafs happening by 
looking at the code. You can find the code for this program on the companion website 
(www.courseptr.com/downloads), in the Chapter 2 folder; the file name is trust_fund_bad.py. 

# Trust Fund Buddy - Bad 

# Demonstrates a logical error 

print( 

II II II 

Trust Fund Buddy 

Totals your monthly spending so that your trust fund doesn't run out 
(and you're forced to get a real job). 

Please enter the requested, monthly costs. Since you're rich, ignore 
cr pennies and use only dollar amounts. 


) 

car = inputCLamborghini Tune-Ups: ") 
rent = inputCManhattan Apartment: ") 
jet = inputCPrivate Jet Rental: ") 
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gifts = inputCGifts: ") 
food = inputCDining Out: ") 

staff = inputCStaff (butlers, chef, driver, assistant): ") 
guru = input("Personal Guru and Coach: ") 
games = input("Computer Games: ") 

total = car + rent + jet + gifts + food + staff + guru + games 

print( "\nGrand Total:", total) 

input( "\n\nPress the enter key to exit.") 

It’s okay if you don’t see the problem right now. Fll give you one more hint, though. Take a 
look at the output in Figure 2.9 again. Examine the long numher that the program prints as 
the grand total. Then look at all the numhers the user entered. Notice any connection? Okay, 
whether you do or don’t, read on. 

Tracking Down Logical Errors 

Logical errors can he the toughest bugs to fix. Since the program doesn’t crash, you don’t get 
the benefit of an error message to offer a clue. You have to observe the behavior of the program 
and investigate the code. 

In this case, the program’s output telis the story. The huge numher is clearly not the sum of 
all the numhers the user entered. But, by looking at the numhers, you can see that the grand 
total printed is a concatenation of all the numhers. How did that happen? Well, if you remem- 
ber, the i nput() function returns a string. So each “numher” the user enters is treated like a 
string. Which means that each variable in the program has a string value associated with it. 
So, the line 

total = car + rent + jet + gifts + food + staff + guru + games 
is not adding numhers. lt’s concatenating strings! 

Now that you know the problem, how do you fix it? Somehow those string values need to be 
converted to numhers. Then the program will work as intended. If only there was some way 
to do this. Well, as you may have guessed, there is. 
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In THE Real World 

The + Symbol works with pairs of strings as well as pairs of integers. Using the same 
operator for values of different types is called operator overloading. Now, "over- 
loading" may sound Uke a bad thing, but actually it can be a good thing. Doesn't it 
make sense that strings are joined usingthe plus sign? You immediately understand 
what it means. Implemented well, operator overloading can make for clearer and 
more elegant code. 


CONVERTING VaLUES 

The solution to the Tmst Fund Buddy—Bad program is to convert the string values returned 
by i nput( ) to numeric ones. Since the program works with whole dollar amounts, it makes 
sense to convert each string to an integer before working with it. 

Introducing the Trust Fund Buddy—Good Program 

The Trust Fund Buddy—Good program fixes the logical bug in Trust Fund Buddy—Bad. Take 
a look at the output of the new program in Figure 2.10. 


[Totals youp monthly spending so that your trust fund doesn't run out 
<and you're forced to get a real job>. 


C:\Python31\python.exe 


HEID 


Trust Fund Buddy 


Please enter the requested, monthly costs. 
and use only dollar amounts. 


Since you're rich, ignore pennies 


T.ariborghini Tune-Ups: 2000 
[Manhattan Bpartment: 10000 
Private Jet Rental: 17000 
[Gifts: 5000 
Dining Out: 7500 

[Staff <butlers, chef, driver, assistant>: 12000 
Personal Guru and Coach: 6800 
[Computer Games: 1000 


Craiid Total: 61300 


Press the enter key to exit. 



Ah, 6 1,300 doLLars 
a month is much 
more reasonabLe, 


Now the program arrives at the correct total. You can find the code for this program on the 
book’s companion website, in the Chapter 2 folder; the file name is trust_fund_good.py. 
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# Trust Fund Buddy - Good 

# Demonstrates type conversion 

pri nt( 

II II II 

Trust Fund Buddy 

Totals your monthly spending so that your trust fund doesn't run out 
(and you're forced to get a real job). 

Please enter the requested, monthly costs. Since you're rich, ignore “P 
cr pennies and use only dollar amounts. 


) 

car = inputCLamborghini Tune-Ups: ") 
car = int(car) 

rent = int(input("Manhattan Apartment: ")) 
jet = int(input("Private Jet Rental: ")) 
gifts = intdnputCGifts: ")) 
food = intdnputCDining Out: ")) 

staff = int(input("Staff (butlers, chef, driver, assistant): ")) 
guru = intdnputCPersonal Guru and Coach: ") ) 
games = intdnputCComputer Games: ")) 

total = car + rent + jet + gifts + food + staff + guru + games 

print( "\nGrand Total:", total) 

input( "\n\nPress the enter key to exit.") 

Converting Strings to Integers 

There are several functions that convert hetween types. The function to convert a value to an 
integer is demonstrated in the following lines: 


car = inputCLamborghini Tune-Ups: ") 
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car = int(car) 

The first line gets input from the user as a string and assigns that value to car. The second 
line does the conversion. The fnnction int( ) takes the string referenced by car and returns 
an integer version of it. Then, car gets this new integer value. 

The next seven lines get and convert the remaining expenditure categories: 

rent = intdnputCManhattan Apartment: ")) 
jet = int(input("Private Jet Rental: ")) 
gifts = intdnputCGifts: ")) 
food = int(input("Dining Out: ")) 

staff = intdnputCStaff (butlers, chef, driver, assistant): ")) 
guru = int(input("Personal Guru and Coach: ") ) 
games = int(input("Computer Games: ")) 

Notice that the assignments are done in just one line. Thafs because the two fnnction calls, 
i nput () and i nt () , are nested. Nesting fnnction calls means putting one inside the other. This 
is perfectly fine as long as the return values of the inner fnnction can be used as argument 
values by the outer fnnction. Here, the return value of i nput( ) is a string, and a string is a 
perfectly acceptable type for i nt( ) to convert. 

In the assignment statement for rent, i nput( ) goes out and asks the user how much the rent 
was. The user enters some text, and that is returned as a string. Then, the program calls the 
function i nt( ) with that string. i nt( ) returns the integer the string represented. Then, that 
integer is assigned to rent. The other six assignment statements work the same way. 

There are other functions that convert values to a specific type. Table 2.4 lists several. 


^ Table 2.4 Selected Type Conversion Functions 


/- 



-> 

Function 

Description 

Example 

Returns 

float(x) 

Returns a floating-point value by converting X 

floatClO.O") 

10.0 

int(x) 

Returns an integer value by converting X 

intClO") 

10 

str(x) 

Returns a string value by converting X 

str(lO) 

'10' 
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Using Augmented Assignment Operators 

Augmented assignment operators is a mouthful. But the concept is simple. Let’s say you want to 
know the yearly amount the user spends on food. To calculate and assign the yearly amount, 
you could use the line 

food = food * 52 

This line multiplies the value of food by 52 and then assigns the resuit back to food. You could 
accomplish the same thing with the following line; 

food *= 52 

*= is an augmented assignment operator. It also multiplies the value of food by 52 and then 
assigns the resuit back to food, but it’s shorter than the first version. Since assigning a new 
value to a variable based on its original value is something that happens a lot in programming, 
these operators provide a nice shortcut to a common task. There are other augmented assign¬ 
ment operators. Table 2.5 summarizes some useful ones. 


^ Table 2.5 

Useful Augment Assignment Operators 


Operator 

Example 

Is Equivalent To 

-\ 


X *= 5 

x = X * 5 


/= 

X /= 5 

X = X / 5 


%= 

x%=5 

x = X % 5 


+= 

X += 5 

X = X + 5 


-= 

X 5 

X = X - 5 





J 


Back to the Useless Trivia Program 

You now Icnow everything you need to know to program the project Useless Trivia from the 
beginning of the chapter. TU present the program a little differently than the others. Instead 
of listing the code out in its entirety, ITl go over the program one section at a time. You can 
find the code for this program on the companion website (www.courseptr.com/downloads), 
in the Chapter 2 folder; the file name is useless_trivia.py. 

Creating the Initial Comments 

Although comments don’t have any effect while the program runs, they are an important 
part of every project. As always, 1 begin with a few: 
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# Useless Trivia 

# 

# Gets personal information from the user and then 

# prints true but useless information about him or her 


Experienced programmers also use the initiaL comments area to describe any 
modifications they make to code over time. This provides a history of the program 
right up f ront. This practice is especiaLLy heLpfuL when severaL programmers have 
their hands on the same code. 

Getting the User Input 

Using the i nput( ) function, the program gets the user’s name, age, and weight: 
name = inputCHi. Whafs your name? ") 

age = inputCHow old are you? ") 
age = int(age) 

weight = int(input("Okay, last question. How many pounds do you weigh? ")) 

Rememher, i nput( ) always returns a string. Since age and wei ght will be treated as numbers, 
they must be converted. I broke up this process into two lines for the variable age. First, I 
assigned the string from i nput () to a variable. Then, 1 converted that string to an integer and 
assigned it back to the variable. For wei ght, 1 made the assignment in one line long by nesting 
the function calls. 1 made the assignments in two different ways to remind you that you can 
do either. However, in practice, Fd pick one approach to be consistent. 

Printing Lowercase and Uppercase Versions of name 

The following lines print a version of name in uppercase and a version in lowercase with the 
help of string methods: 

print(''\nlf poet ee cummings were to email you, he'd address you as", "^1 
□T name.lowerO) 

printCBut if ee were mad, he'd call you", name.upperO) 

ee cummings, by the way, was an experimental American poet who didn’t use uppercase 
letters. So, if he were alive and e-mailing you, he’d probably use all lowercase letters in your 
name. But if he were mad, he’d probably make an exception and “shout” via e-mail by 
addressing you in uppercase. 



Python Programming for the Absolute Beginner, Third Edition 



Printing name Five Times 

The program displays the user’s name five times in a row using string repetition: 
cal1ed = name * 5 

print("\nlf a small child were trying to get your attention",) 
printCyour name wouid become:") 
print(cal1ed) 

The variable called is assigned the value of name, repeated five times. Then, a message is 
printed followed hy cal 1 ed. 

CalcuLating seconds 

The user’s age, in seconds, is calculated and printed in the two following lines: 

seconds = age * 365 * 24 * 60 * 60 

print( "\nYou' re over", seconds, "seconds old.") 

Since there are 365 days in a year, 24 hours in a day, 60 minutes in an hour, and 60 seconds 
in a minute, age is multiplied hy the product of 365 * 24 * 60 * 60. This value is assigned to 
seconds. The next line displays the resuit. 

CalcuLating moon_weight and sun_weight 

The next four lines calculate and display the user’s weight on the moon and sun: 
moon_weight = weight / 6 

print("\nDid you know that on the moon you wouid weigh only", 
moon_weight, "pounds?") 

sun_weight = weight * 27.1 

printCOn the sun, you'd weigh", sun_weight, "(but, ah... not for long).") 

Since the moon has one-sixth the gravitational pull of the earth, moon_wei ght is assigned the 
value of wei ght divided hy 6. And since the gravitational force on the sun is about 27.1 times 
stronger than it is here on Earth, 1 multiply weight hy 27.1 and assign the resuit to 
sun_weight. 

Waiting for the User 

The last statement waits for the user to press the Enter key: 


input( "\n\nPress the enter key to exit.") 


Chapter2 • Types, Variables, and Simple 1/0: The Useless Trivia Program 


© 


SUMMARY 

In this chapter, you saw how to create strings with single, double, and triple quotes. You 
learned how to include special characters in them with escape sequences. You saw how to 
join and repeat strings. You learned ahout two different numeric types, integers and floating- 
point numhers, and how to work with them. You also now know how to convert values 
hetween strings and numhers. You learned ahout variahles and saw how to use them to store 
and retrieve Information. Finally, you learned how to get user input to make your programs 
Interactive. 
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Challenges 

1. Create a List of legal and illegal variable names. Describe why 
each is either legal or illegal. Next, create a list of "good" and 
“bad" legal variable names. Describe why each is either a good 
or bad choice for a variable name. 

2. Write a program that allows a user to enter his or her two 
favorite foods. The program should then print out the name of 
a newfood byjoiningthe originalfood names together. 

3. Write a Tipper program where the user enters a restaurant 
bili total. The program should then display two amounts: a 
15 percent tip and a 20 percent tip. 

4. Write a Car Salesman program where the user enters the base 
price of a car. The program should add on a bunch of extra fees 
such as tax, license, dealer prep, and destination charge. Make 
tax and license a percent of the base price. The other fees 
should be set values. Display the actual price of the car once 
all the extras are applied. 
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BrANCHINGj while Loops^ 
AND Program Planning: 
The Guess My Number 

Game 


S o far, the programs youVe written have had a simple, sequential flow: each 
statement is executed once, in order, every time. Ifyou were limited to just 
this type of programming, it would be very difficult, if not impossible, to 
write complex applications. But in this chapter, you learn how to selectively exe- 
cute certain portions ofyour code and repeat parts ofyour program. Specifically, 
you learn to do the following: 

• Generate random numbers using randintO and randrangeO 
• Use i f statements to execute code based on a condition 
• Use an el se clause to make a choice based on a condition 
• Use el i f clauses to make a choice based on several conditions 
• Use while loops to repeat parts of your program 
• Plan your programs using pseudocode 
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Introducing THE GuESS My Number Game 

The program you’ll create in this chapter is the classic numher guessing game. For those who 
missed out on it in their childhood, the game goes like this: the computer chooses a random 
number between 1 and 100 and the player tries to guess it in as few attempts as possible. Each 
time the player enters a guess, the computer telis the player whether the guess is too high, 
too low, or right on the money. Once the player guesses the number, the game is over. Figure 
3.1 shows Guess My Number in aedon. 



Got it in onLy three 
guesses! Tty to 
beat that. 


| [^| L :\Python31\pythQn.exe 


HEID 


Uelcome to 'Guess My Nunher' 


I'm thinking of a number between 1 and 100. 

Try to guess it in as few attempts as possible. 


Fake a guess: 50 
Fiower... 

|Take a guess: 25 
Lower... 

Take a guess: 15 

Vou guessed it! The number was 15 
Hnd it only took you 3 tries! 


Press the enter key to exit. 


Generating Random Numbers 

As much as users want consistent, predictable results from programs, sometimes what makes 
the programs exciting is their unpredictability: the sudden change in a computer opponenfs 
strategy, or an alien creature bursting out from an arbitrary door. Random numbers can 
supply this element of chance or surprise, and Python provides an easy way to generate those 
random numbers. 



Python generales random numbers based on a formula, so they are not truLy 
random. This kind of random generation is caLLed pseudorandom and is good 
enough for most appLications (just don’t try to start an Online casino with it). If 
you really need truly random numbers, visit http://www.fourmilab.ch/hotbits/. 
The site generales random numbers based on the natural and unpredictable 
process of radioactive decay. 


Introducing the Craps RoLler Program 

Craps Roller replicates the dice roll of the fast-paced, casino game of craps. But you don’t have 
to know anything about craps to appreciate the program. Craps Roller just simulates the roll 
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of two, six-sided dice. It displays the value of each and their total. To determine the dice values, 
the program uses functions that generate random numbers. Figure 3.2 shows the program 
in aedon. 




Ack! Igot a totaLof 
7 on my first roLL, 
which means I 
Lose. 


You can find the code for this program on the companion website for this book 
(www.courseptr.com/downloads), in the Chapter 3 folder; the file name is craps_roller.py. 

# Craps Rol1 er 

# Demonstrates random number generation 
import random 

# generate random numbers 1 - 6 
diei = random.randintd, 6) 
die2 = random.randrange(6) + 1 

total = diei + die2 

printCYou rolled a", diei, "and a", die2, "for a total of", total) 
input("\n\nPress the enter key to exit.") 


Importing the random Module 

The first line of code in the program introduces the import statement. The statement allows 
you to import, or load, modules, in this case, the random module: 
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random 

Modules are files that contain code meant to be used in other programs. These modules usually 
group together a collection of programming related to one area. The random module contains 
functions related to generating random numbers and producing random results. 

If you think of your program as a construction project, then modules are like special toolkits 
that you can pull out from the garage when you need them. But instead of going to the shelf 
and grabbing a powered, circular saw, here 1 imported the random module. 

Usingthe randint() Function 

The random module contains a function, randintO, which produces a random integer. The 
Craps Roller program accesses randi nt( ) through the following function call: 

random.randintd, 6) 

YouTl notice the program doesnT directly call randintO. Instead, the program calls the func¬ 
tion with random.randint( ), accessing the function randintO through its module, random. In 
general, you can call a function from an imported module by giving the module name, fol- 
lowed by a period, followed by the function call itself. This method of access is called dot 
notatiori. Dot notation is like the possessive in English. In English, “Mike’s Eerrari” means that 
it’s the Ferrari thatbelongs to Mike. Using dot notation, random. randi nt( ) means the function 
randi nt( ) that belongs to the module random. Dot notation can be used to access different 
elements of imported modules. 

The randintO function requires two integer argument values and returns a random integer 
between those two values, which may include either of the argument values. So, by passing 
the values 1 and 6 to the function. Em guaranteed to get back either 1, 2, 3, 4, 5, or 6. Since 
Em simulating the roll of a six-sided die, this is perfect. 

Using the randrange() Function 

The random module also contains a function, randrangeO, which produces a random integer. 
There are several ways to call randrange( ), but the simplest is to use a single, positive, integer 
argument. Called this way, the function returns a random integer from, and including, 0, up 
to, but not including, that number. So the call to random. randrange(6) produces either a 0,1, 
2, 3, 4, or 5. Alright, where’s the 6? Well, randrange( ) is picking a random number from a 
group of six numbers—and the list of numbers starts with 0. So, 1 just added 1 to the resuit to 
get the right value for a di e2: 

die2 = random.randrange(6) -i- 1 
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As a resuit, di eZ gets either a 1, 2, 3, 4, 5, or 6. 



I used boththe randi nt( ) and randrange( ) functionsintheCrapsRoLLerprogram 
so that I couLd show off two different functions for generating random numbers. 
In generaL, you'LL want to pick the function that best fits your needs. 


USING THE IF StATEMENT 

Branching is a fundamental part of computer programming. It basically means making a deci- 
sion to take one path or another. Through the i f statement, your programs can branch to a 
section of code or just skip it, ali based on how you’ve set things up. 

Introducing the Password Program 

The Password program uses the i f statement to simulate the login procedure of a highly 
secure computer system. The program grants the user access if he or she enters the correct 
password. Figures 3.3 and 3.4 show a few sample runs. 

You can find the code for this program on the companion website for this book 
(www.courseptr.com/downloads), in the Chapter 3 folder; the file name is password.py. 



Ha, you’LL never 
crack the code. 
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Guess I shouLd 
have picked a 
better password 
than "secret." 



# Password 

# Demonstrates the if statement 

print("Welcome to System Security Inc.") 
printC'-- where security is our middle name\n") 

password = inputCEnter your password: ") 

if password == "secret": 
print("Access Granted") 

input( "\n\nPress the enter key to exit.") 


In THE Real World 


While the program Password does a good job of demonstrating the i f statement, it's 
not a good example of how to implement computer security. In fact, anyone could 
simply examine the source code and discover the “secret" password. 

To create a password validation system, a programmer would most Ilkely use some 
form of cryptography. Cryptography, an anclent idea that dates back thousands of 
years, is used to encode Information so that only the intended recipients can under- 
stand it. Cryptography is an entire field unto itself and some computer scientists 
devote their careers to it. 
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Examining the if Statement 

The key to program Password is the i f statement: 

if password == "secret": 
print("Access Granted") 

The i f statement is pretty straightforward. You can probably figure out whafs happening 
just by reading the code. If password is equal to "secret", then "Access Granted" is printed 
and the program continues to the next statement. But, if it isn’t equal to "secret", the pro¬ 
gram does not print the message and continues directly to the next statement following the 
i f statement. 


Creating Conditions 

All i f statements have a condition. A condition is just an expression that is either true or false. 
You’re already familiar with conditions. They’re pretty common in daily life. In fact, almost 
any statement you make could be viewed as a condition. For example, the statement “It’s 100 
degrees outside.” could be treated as a condition. It’s either true or false. 

Python has its own, built-in values to represent truth and falsehood. True represents true and 
False (drumroll) represents false. A condition can always be evaluated to one of these. In the 
Password program, the condition used in the i f statement is password == "secret". It means 
that password is equal to, or refers to the value, "secret". This condition evaluates to either 
True or False, depending on the value of password. If the value of password is equal to 
"secret", then the condition is True. Otherwise, the condition is False. 


Understanding Comparison Operators 

Conditions are often created by comparing values. You can compare values using comparison 
operators. YouVe already seen one comparison operator by way of the Password program. It’s 
the equal-to comparison operator, written as ==. 



The equal-to comparison operator is two equal signs in a row. Using just one 
equal sign in a condition will resuit in a syntax error, because one equal sign 
represents the assignment operator. So, password = "secret" is an assignment 
statement. It assigns a value. And password == " secret " is a condition. It evalu¬ 
ates to either True or False. Even though the assignment operator and the equal- 
to operator look similar, they are two different things. 


In addition to equal-to, there are other comparison operators. Table 3.1 summarizes some 
useful ones. 



© 


Python Programming for the Absolute Beginner, Third Edition 



Using comparison operators, you can compare integers to integers, floating-point numbers 
to floating-point numbers, as well as integers to floating-point numbers. You can even com¬ 
pare strings—the results are based on alphabetical order. For example, "appl e" < "orange" is 
Truebecause "apple" is alphabeticallyless than "orange" (it comes before itinthe dictionary). 



Python won't Letyou make certain comparisons. Objects of different types that 
don't have an estabLished definition for order can't be compared using the <, <=, 
>, or >= operators. For exampLe, Python won't Let you use these operators to 
compare strings and integers. Go ahead, try to use the condition 10 > "fi ve" in 
your program—aLLyoulL do is generate a big, fat error message. 


Using Indentation to Create BLocks 

You may have noticed that the second line of the i f statement, pri nt( "Access Granted" ), is 
indented. By indenting the line, it becomes a block. A block is one or more consecutive lines 
indented by the same amount. Indenting sets lines off not only visually, but logically too. 
Together, they form a single unit. 

Blocks can be used, among other ways, as part of an i f statement. They’re the statement or 
group of statements that gets executed if the condition is True. In the Password program, the 
block is the single statement pri nt( "Access Granted"). 

Since blocks can be as many statements as you like, you could add a special welcome for users 
who enter the proper password by changing the block in the i f statement like so: 

if password == "secret": 
print("Access Granted") 

print("Welcome! You must be someone very important.") 
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Now, users who correctly enter the secret password will see Access Granted followed by Wel - 
come! You must be someone very important. Andifauser enters somethingbesides secret, the 
User won’t see either of the messages. 

There's passionate debate within the Python community about whether to use 
tabs or spaces (and if spaces, the number to use) for indentation. This is reaLLy a 
question of personat style. But there are two guidelines worth foLLowing. First, 
be consistent. If you indent blocks with two spaces, then always use two spaces. 
Second, don't mix spaces and tabs. Even though you can Line up bLocks using a 
combination of both, this can Lead to big headaches Later. Common indentation 
styLes include one tab, or two spaces, or (the style the creator of Python uses) 
four spaces. The choice is yours. 



Building Your Own if Statement 

YouVe seen a full example of an i f statement, but I want to leave the topic by summarizing 
howto buildyour own. You can construet an i f statement by using i f , followed by a condition, 
followed by a colon, followed by a block of one or more statements. If the condition evaluates 
to T rue, then the statements that make up the block are exeeuted. If the condition evaluates 
to Fal se, then the program moves on to the next statement after the i f statement. 

Using the else Clause 

Sometimes you’ll want your program to “make a choice” based on a condition: do one thing 
if the condition is true, do something else if it’s false. The el se clause, when used in an i f 
statement, gives you that power. 

Introducing the Granted or Denied Program 

The program Password did a good job welcoming a user who entered the correct password, 
but it didn’t do anything if the wrong password was entered. Program Granted or Denied 
solves this problem by using an el se clause. Figures 3.5 and 3.6 showoffthe newand improved 


version. 
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Q FIGURE3.5 ^ 

The correct 
password grants 
the User access, 
just Like before. 


Figure3.6 ^ 

Now, an Incorrect 
password 
generates the 
stinging "Denied" 
message. 




You can find the code for this program on the companion website, in the Chapter 3 folder; 
the file name is granted_or_denied.py. 

# Granted or Denied 

# Demonstrates an else clause 

print("Welcome to System Security Inc.") 
printC'-- where security is our middle name\n") 

password = inputCEnter your password: ") 

if password == "secret": 
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print("Access Granted") 
else: 

print("Access Denied") 
input("\n\nPress the enter key to exit.") 

Examining the else Clause 

I only made one change from the Password program. I added an else clause to the if 
statement: 

if password == "secret": 

print("Access Granted") 
else: 

print("Access Denied") 

If the value of p a s s w o r d is equal to " s e c r e t ", the program prints Access Granted, just like before. 
But thanks to the else clause, the program prints Access Denied otherwise. 

In an i f statement with an else clause, exactly one of the code hlocks will execute. If the 
condition is true, then the hlock immediately following the condition is executed. If the 
condition is false, then the hlock immediately after the el se is executed. 

You can create an else clause immediately following the i f hlock with else, followed by a 
colon, followed by a hlock of statements. The else clause must be in the same hlock as its 
corresponding i f. That is, the el se and i f must be indented the same amount. 

USING THE ELIF ClAUSE 

Your program can choose from among several possibilities in an i f statement with the use 
of the el i f clause. This clause comes in quite handy when you have one variable that you 
want to compare to a bunch of different values. 

Introducing the Mood Computer Program 

In the mid-1970s (yes, last century), there was a wildly successful fad product called the Mood 
Ring. The ring revealed the wearer’s mood through a color-changing gem. Well, the Mood 
Computer program takes the technology to the next level by looking into the psyche of the 
User and displaying his or her mood. Figure 3.7 reveals my mood while writing this very 
chapter. 
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Q FIGURE3.7 ^ 

Looks Like I was in a 
great mood whiLe 
writing the Mood 
Computer 
program. 



Okay, the program doesn’t really plumb the emotional depths of the user through electro- 
dermal impulses transmitted via the keyboard. Instead, Mood Computer generates a random 
number to choose one of three faces to print using an i f statement with el i f clauses. (By the 
way, the Mood Ring didn’t really reveal the wearer’s emotions either. It was just an LCD that 
changed colors based on body temperature.) 

You can find the code for this program on the downloads site (www.courseptr.com/ 
downloads), in the Chapter 3 folder; the file name is mood_computer.py. 

# Mood Computer 

# Demonstrates the elif clause 
import random 

printCI sense your energy. Your true emotions are coming across my screen.") 
print("You are...") 

mood = random.randintd, 3) 

if mood == 1: 

# happy 
print( \ 
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0 0 
< 


elif mood == 2: 
# neutral 
print( \ 


0 0 
< 


elif mood == 3: 
# sad 
print( \ 


0 0 
< 


ir II II ^ 

else: 

printCIllegal mood value! (You must be in a really bad mood).") 
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print("...today.") 


input( "\n\nPress the enter key to exit.") 


Examining the elif Clause 

An if statement with elif clauses can contain a sequence of conditions for a program to 
evaluate. In Mood Computer, the lines containing the different conditions are 

• if mood == 0: 

• elif mood == 1: 

• elif mood == 2: 

Notice that you write the first condition using an i f , but then test the remaining conditions 
using el i f (short for “else if’) clauses. You can have as many el i f clauses as you like. 

By isolating the conditions, you can see the purpose of the structure: to test mood against three 
different values. The program first checks to see if mood is equal to 0. If it is, then the happy 
face is printed. If not, the program moves to the next condition and checks if mood is equal to 
1. If it is, the neutral face is printed. If not, the program checks if mood is equal to 2. If so, the 
sad face is printed. 



An importantfeatureof an i f statement with e 1 i f clauses is that once a condition 
evaluates to True, the computer executes its corresponding block and exits the 
statement. This means that at most, onLy one block executes, even if several 
conditions would evaluate to True. In Mood Computer, that's no big deal. mood 
can only be equal to a single number, so only one of the conditions can be true. 
But if s important to be aware of this behavior because if s possible to create 
statements where more than one condition can be true at the same time. In that 
case, only the block associated with the first true condition executes. 


If none of the preceding conditions for mood turn out to be True, then the final el se clause’s 
block runs and IIlega 1 mood value! (You must be in a really bad mood). appears on the 
screen. This should never happen, since mood will always be 0, 1, or 2. But I put the clause in 
there just in case. I didn’t have to, though, since the final else clause is optional. 



Though if s not necessary to use the final el se clause, if s a good idea. It works as 
a catchall for when none of the conditions within the statement are T rue. Even 
if you think one of your conditions will always be True, you can stili use the final 
el se clause to catch the "impossible" case, like I did. 
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YouVe seen three similar, but progressively more powerflil branching structures. For a con¬ 
cise review, check out Table 3.2. 



Creating while Loops 

Loops are all around us. Even your shampoo bottle has looping instructions on it: “While your 
hair is dirty: Rinse. Lather. Repeat.” This may seem like a simple idea—while some condition 
is true, repeat something—but it’s a powerful tool in programming. It would come in quite 
handy, for example, in making a quiz show game. You might want to teli your program: while 
there are questions left, keep playing the game. Or, in a banking application, you might want 
to teli your program: while the user hasn’t entered a valid account number, keep asking the 
User for an account number. The while loop lets you do exactly this. 

Introducing the Three-Year-Old Simulator Program 

In today’s fast-paced world, many people don’t get to spend the time they’d like with the 
children in their lives. A busy lawyer might be stuck at the office and not see her small son. 
A salesman might he on the road and not see his little niece. Well, the Three-Year-Old 
Simulator solves that problem by reproducing a conversation with a three-year-old child. 
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The key to mimicking a three-year-old, it turns out, is the while loop. Figure 3.8 shows a 
sample run. 


Figure 3.8 ^ 

If youve ever been 
in charge of a 
three-year-oLd, 
this shouLd bring 
back warm 
memories. 



As you can see, the program keeps asldng Why? until the answer, Because ., is entered. You can 
find the code for this program on the companion website, in the Chapter 3 folder; the file 
name is three_year-old.py. 

# Three Year-Old Simulator 

# Demonstrates the while loop 

print( "\tWel come to the 'Three-Year-01d Simulator'\n") 

printCThis program simulates a conversation with a three-year-old child.") 

printCTry to stop the madness.Yn") 

response = 

while response != "Because.": 
response = input("Why?\n") 

printCOh. Okay.") 

input( "\n\nPress the enter key to exit.") 

Examining the while Loop 

The loop from the Three-Year-Old Simulator program is just two lines: 
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while response != "Because.": 
response = input("Why?\n") 

Ifthe format ofthe while loop looks familiar, there’s agoodreason. Itbears astrikingresem- 
blance to its cousin, the i f statement. The only difference is that i f is replaced hy whi 1 e. And 
the similarities aren’t just sldn-deep. In both statement types, if the condition is true, the 
block (sometimes call the loop body in a loop) is executed. But in the while statement, the 
computer tests the condition and executes the block over and over, untii the condition is 
false. Thafs why it’s called a loop. 

In this case, the loop body is just response = i nput( "Why?\n'' ), which will continue to execute 
untii the user enters Because.. At that point, response != "Because." is false and the loop 
mercifully ends. Then, the program executes the next statement, pri nt( "Oh. Okay. "). 


Initializing the Sentry Variable 

Often, while loops are controlled by a sentry variable, a variable used in the condition and 
compared to some other value or values. Like a human sentry, you can think of your sentry 
variable as a guard, helping form a barrier around the while Ioop’s block. In the Three-Year- 
Old Simulator program, the sentry variable is response. It’s used in the condition and is 
compared to the string "Because. " before the block is executed each time. 

It’s important to initialize your sentry variable. Most of the time, sentry variahies are initial- 
ized right before the loop itseif. Thafs what I did with: 

response = "" 



If the sentry variable doesn't have a value when the condition is evaluated, your 
program will generate an error. 


If s usually a good idea to initialize your sentry variahies to some t 5 rpe of empty value. I assign 
"", the empty string, to response. While I couid assign the string " a a r d v a r k ", and the program 
wouid Work just the same, it wouid make the code neediessiy confusing. 

Checking the Sentry Variable 

Make sure that if s possible for the while condition to evaluate to True at some point; other- 
wise, the block will never run. Take, for example, one minor change to the loop you’ve heen 
working with: 
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response = "Because." 
while response != "Because.": 
response = input("Why?\n") 

Since responseis equal to "Because." right before the loop, the block will never run. 

Updating the Sentry Variable 

Once you’ve established your condition, initialized your sentry variable, and are sure that 
under some conditions the loop block will execute, you have yourself a worldng loop. Next, 
make sure the loop will end at some point. 

If you write a loop that never stops, youVe created an infinite loop. Welcome to the club. At 
one time or another, all programmers have accidentally created an infinite loop and watched 
their program get stuck doing something over and over. Or they see their programs just plain 
freeze up. 

Here’s a simple example of an infinite loop: 

counter = 0 
while counter <= 10 
print(counter) 

The programmer probably intended the loop to print the numbers from 0 to 10. Unfortu- 
nately, what this program does is print 0, forever. The programmer forgot to change 
counter, the sentry variable, inside the loop body. So remember, the values in the condition 
must be able to change as a resuit of the code inside the loop body. If they can’t ever change, 
the loop won’t end, and you end up with an infinite loop. 

Avoiding Infinite Loops 

One t 5 rpe of infinite loop is where the sentry variable is never updated, like you just saw. But 
there are more insidious forms of the never-ending loop. Check out the next program. It does 
change the value of the sentry variable in the loop body. But something is wrong, because the 
loop never ends. See if you can spot the trouble before 1 explain whafs going on. 

Introducing the Losing Battle Program 

The Losing Battle program describes the last, valiant fight of a hero overwhelmed by an army 
of trolls, a scenario you might find in a role-playing game. The program narrates the battle 
action. It describes the struggle, blow-by-blow, as the hero defeats a troll, but then takes more 
damage. In the end, the program always ends with the death of the hero. Or does it? You can 
find the code for this program on the companion website, in the Chapter 3 folder; the file 
name is losing_battle-bad.py. 
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# Losing Batti e 

# Demonstrates the dreaded infinite loop 

printCYour Ione hero is surrounded by a massive army of trolls.") 
print("Their decaying green bodies stretch out, melting into the horizon.") 
printCYour hero unsheathes his sword for the last fight of his life.Xn") 

health = 10 
trol1s = 0 
damage = 3 

while health != 0: 
trolls += 1 
health -= damage 

printCYour hero swings and defeats an evil troll, " \ 

"but takes", damage, "damage points.Xn") 

printCYour hero fought valiantly and defeated", trolls, "trolls.") 
printCBut alas, your hero is no more.") 

inputC\n\nPress the enter key to exit.") 

Figure 3.9 shows a run of the program. This resulted in an infinite loop and I had to stop the 
process hy pressing Ctrl+C, or it would have continued. 


| [c^ C:\Python31\python.exe 
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swings 

and 

defeats 

an 

euil 

troll, but 

takes 

3 

damage 

points 

Voui* 

hero 

swings 

and 

defeats 

an 

euil 

troll, but 

takes 

3 

damage 

points 

Voui* 

hero 

swings 

and 

defeats 

an 

euil 

troll, but 

takes 

3 

damage 

points 



It seems you have 
an ImmortaL hero 
The onLy way to 
end the program 
was to stop the 
process. 
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So, whafs going on? 


Tracingthe Program 

Well, it looks like the program has a logical error. A good way to track down this kind of error 
is to trace your program’s execution. Tracing means you simulate the running ofyour program 
and do exactly what it would do, following every statement and keeping track of the values 
assigned to variables. This way, you can step through the program, understand exactly what 
is happening at each point, and discover the circumstances that conspire to produce the bug 
in your code. 

The most basic way to trace a program is with old-fashioned pencil and paper. I created 
columns, one for each variable and condition. So to start, my page looks like this: 

health trolls damage health != 0 

Right after the condition of the whi 1 e loop is evaluated, my page looks like this: 

health trolls damage health != 0 

10 0 3 True 


Since the condition is True, the loop executes for the first time. After one full time through 
and back up to evaluate the condition again, my trace looks like this: 


Health trolls damage 

10 0 3 

7 1 3 


health != 0 

True 

True 


After a few more times through the loop, my trace looks like: 


health 

10 

7 

4 

1 

-2 

-5 

-7 


trol 1 s 
0 
1 
2 

3 

4 

5 

6 


damage 

3 

3 

3 

3 

3 

3 

3 


health != 0 

True 

True 

True 

True 

True 

True 

True 


I stopped the trace because it seemed like I was in an infinite loop. Since the value of health 
is negative (and not equal to 0) in the last three lines of the trace, the condition is stili True. 
The problem is, health will never become 0. It will just grow in the negative direction each 
time the loop executes. As a resuit, the condition will never become Fal se, and the loop will 
never end. 
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Creating Conditions That Can Become False 

In addition to making sure values in a whi 1 e loop’s condition change, you should be sure that 
the condition can eventually evaluate to False; otherwise, you stili have an infinite loop on 
your hands. In the case of the Losing Battle program, the fix is easy. The line with the condition 
just needs to hecome 

while health > 0: 

You can find the code for this program on the companion wehsite, in the Chapter 3 folder; 
the file name is losing_hattle-good.py. 

Now, if heal th hecomes 0 or negative, the condition evaluates to False and the loop ends. To 


be sure, you can trace the program using this new condition: 

health 

trol 1 s 

damage 

health > 0 

10 

0 

3 

True 

7 

1 

3 

True 

4 

2 

3 

True 

1 

3 

3 

True 

-2 

4 

3 

False 

And the program ends as it should. Figure 3.10 shows how the dehugged program runs 


\Python31\python.exe 


Hil 


Voui* Ione hero is surrounded by a Piassioe arny of trolls. 

Their decaying green bodies stretch out, melting into the horizon. 
Your hero unsheathes his sword for the last fight of his life. 


Your 

hero 

swings 

and 

defeats 

an 

euil 

troll, but 

takes 

3 

danage 

points 

Your 

hero 

swings 

and 

defeats 

an 

euil 

troll, but 

takes 

3 

danage 

points 

Your 

hero 

swings 

and 

defeats 

an 

euil 

troll, but 

takes 

3 

danage 

points 

Your 

hero 

swings 

and 

defeats 

an 

evil 

troll, but 

takes 

3 

danage 

points 


[Vour hero fought valiantly and defeated 4 trolls. 
Riit alas^ your hero is no no re. 


Press the enter key to exit._ 


Q Figure3.io 3 

Now the program 
runs correctly, 
avoidlng an infinite 
Loop. Your hero's 
fate, however, is 
not as bright. 


Treating Values as Conditions 

If I asked you to evaluate 35 + 2 you’d come back quicldy with 37. But if I asked you to evaluate 
37 as either true or false, you’d prohahly come back with, “Huh?” But the idea of looking at 
any value as either true or false is valid in Python. Any value, of any type, can be treated this 
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way. So, 2749, 8.6, "banana", 0, and "" can eachbe interpreted as True or Fal se. This may seem 
bizarre, but it’s easy. Tbe rules tbat establisb True and False are simple. More importantly, 
interpreting values tbis way can make for more elegant conditions. 

Introducing the Maitre D' Program 

If you baven’t been snubbed at a fancy, Frencb restaurant lately, tben 1 bave just tbe program 
for you. Maitre D’ welcomes you to tbe fine eatery and tben asks you bow mucb money you 
slip your bost. If you give zero dollars, tben you are rigbtly ignored. If you give some otber 
amount, tben your table is waiting. Figures 3.11 and 3.12 sbow off tbe program. 


Q FlGURE3.ll ^ 

Whenyou don'ttip 
the maitre d', there 
are no tabLes to be 
found. 


C:\Python31\python.exe 


V^e]coine to the Omteau D' Food 

It seems we quite full this euening. 

How many dollat*s do you slip the Maiti*e D'? 0 
Please, sit. It map be a while. 


Press the enter key to exit. 


hi 


Q F|GURE3.I2 3 

This time, my 
money has heLped 
cure the maitre d’ 
of his amnesia. 


(Sll 


C:\Python31\python.exe 


psn 


V^elcome to the Clmteau D' Food 

It seems we at*e quite full this euening. 

How many dolla>*s do you slip the Maitre D'? 20 
Hh. I am reminded of a table. Right this way. 


Press the enter key to exit._ 


hi 
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From watching the program run, you might not be impressed. This seems like something 
you could have already done. The difference is, there is no comparison operator used in this 
program. Instead, a value (the amount of money) is treated as a condition. You can find the 
code for this program on the companion wehsite (www.courseptr.com/downloads), in the 
Chapter 3 folder; the file name is maitre_d.py. 

# Maitre D' 

# Demonstrates treating a value as a condition 

print("Welcome to the Chateau D' Food") 
printCIt seems we are quite full this evening.\n") 

money = int(input("How many dollars do you slip the Maitre D'? ")) 

if money: 

printCAh, I am reminded of a table. Right this way.") 
else: 

printCPlease, sit. It may be a while.") 
input(''\n\nPress the enter key to exit.") 

Interpreting Any Value as True or False 

The new concept is demonstrated in the line: 
if money: 

Notice that money is not compared to any other value. money is the condition. When it comes 
to evaluating a numher as a condition, 0 is False and everything else is True. So, the ahove 
line is equivalent to 

if money != 0: 

The first version is simpler, more elegant, and more intuitive. It reads more naturally and 
could be translated to “if there is money.” 

The rules for what makes a value True or False are simple. The basic principal is this: any 
empty or zero value is Fal se, everything else is True. So, 0 evaluates to False, hut any other 
number evaluates to T r u e . The empty string, , is False, while any other string is T r u e . As you 
can see, most every value is True. It’s only the empty or zero value thafs Fal se. You T1 find that 
testing for an empty value is a common thing to do, so this way of treating values can come 
up a lot in programs. 
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One last thing to note here is that if you enter a negative dollar amount, the maitre d’ will 
stili Seat you. Rememher, for numbers, only 0 is Fal se. So, all negative numbers are True, just 
like positive ones. 

Creating Intentional Infinite Loops 

Corning soon after a section called “Avoiding Infinite Loops,” you might be more than a bit 
surprised to see a section about creating infinite loops. Aren’t infinite loops always a mistake? 
Well, if a loop were truly infinite—that is, it could never end, then yes, it would be a logical 
error. But what 1 call intentional infinite loops are infinite loops with an exit condition built into 
the loop body. The best way to understand an intentional infinite loop is to see an example. 

Introducing the Finicky Counter Program 

The Finicky Counter program counts from 1 to 10 using an intentional infinite loop. lt’s 
finicky because it doesnT like the number 5 and skips it. Figure 3.13 shows a run of the 
program. 


Figure 3.13 ^ 

The number 5 is 
skipped with a 

continue 

statement and the 
Loop ends through 
a break 
statement. 


iH 


^[C:\Python31 \python.exe 


1 

2 

.] 

fi 

6 

7 

8 
9 

19 


Press the entei' key to exit. 


You can find the code for this program on the companion website, in the Chapter 3 folder; 
the file name is finicky_counter.py. 

# Finicky Counter 

# Demonstrates the break and continue statements 

count = 0 
while True: 
count += 1 
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# end loop if count greater than 10 
if count > 10: 

break 

# skip 5 

if count == 5: 

continue 
print(count) 

input(''\n\nPress the enter key to exit.") 

Using the break Statement to Exit a Loop 

I set up the loop with: 

while True: 

This technically means that the loop will continue forever, unless there is an exit condition 
in the loop body. Luckily, 1 put one in: 

# end loop if count greater than 10 
if count > 10: 

break 

Since c o u n t is increased by 1 each time the loop body begins, it will eventually reach 11. When 
it does, the break statement, which here means “break out of the loop,” is executed and the 
loop ends. 

Using the continue Statement to Jump Back to the Top of a Loop 

Just before count is printed, 1 included the lines: 

# skip 5 

if count == 5: 
continue 

The conti nue statement means “jump back to the top of the loop.” At the top of the loop, the 
while condition is tested and the loop is entered again if it evaluates to T rue. So when count 
is equal to 5, the program does not get to the print(count) statement. Instead, it goes right 
back to the top of the loop so that 5 is never printed. 

Understanding When to Use break and continue 

You can use break and continue in any loop you create. They aren’t just restricted for use in 
intentional infinite loops. But they should be used sparingly. Both break and conti nue make 
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it harder for someone (including you!) to see the flow of a loop and understand under what 
conditions it ends. Plus, you don’t actually need break and continue. Any loop you can write 
using them can be written without them. 

In Python, there are times when an intentional infinite loop can be clearer than a traditional 
loop. In those cases, where it’s really clunlcy to write the loop with a regular condition, some 
programmers use intentional infinite loops. 

Using Compound Conditions 

So far, you’ve only seen comparisons where exactly two values are involved. These are called 
simple conditions. But you may find yourself wishing for more power. Luckily, you can combine 
simple conditions together with logical operators. Combined, these simple conditions become 
compound conditions. Using compound conditions, your programs can make decisions based 
on how multiple groups of values compare. 

Introducing the Exclusive NetWork Program 

Exclusive clubs are no fun, unless you’re a member. So, 1 created the Exclusive NetWork pro¬ 
gram. It simulates an elite computer network where only a select few are members. The 
membership consists of me and several top game designers in the world today (not bad 
company). 

Like real-world computer systems, each person has to enter a username and a password. A 
member has to enter both his or her username and password, or the member won’t be able 
to log in. With a successful login, the member is personally greeted. Also like real-world Sys¬ 
tems, everyone has a security level. 

Because Em not a total elitist, guests are allowed to log in. Guests have the lowest security 
level, though. Figures 3.14 through 3.16 show off the program. 
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^ Figure3 .I4 ) 

If youYe not a 
member or a 
guest, you can't 
get in. 


C:\ Pvthon31\pvthon.exe 

Pxcliisive Computei* Netwoj*k 
neinbe>*s only! 

llsername: B.Gates 
Password: guest 
Uelcome, guest. 


Press the entei* key to exit. 




1_ 



|^2^C:\Python31 \python.exe 

HEI 

3 


Members onlyt 


iisername: S.Miyamoto 
Password: mariobros 
lJbrtt's up.. Shigeru? 


Press the enter key to exit. 


^ FIGURE3.I5 ) 

A guest can Log in, 
but his security 
LeveL is set quite 
Low. 


^ Figure3.i6 ) 


Looks Like one of 
the guys Logged in 
today. 
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You can find the code for this program on the companion website, in the Chapter 3 folder; 
the file name is exclusive_network.py. 

# Exclusive Network 

# Demonstrates logical operators and compound conditions 

print( "\tExcl usi ve Computer Network") 
print( "\t\tMembers only!\n") 

security = 0 

username = 
while not username: 

username = inputCUsername: ") 

password = 
while not password: 

password = inputCPassword: ") 

if username == "M.Dawson" and password == "secret": 
printCHi, Mike.") 
security = 5 

elif username == "S.Meier" and password == "civi 1 ization": 
printCHey, Sid.") 
security = 3 

elif username == "S.Miyamoto" and password == "mariobros": 
print("What's up, Shigeru?") 
security = 3 

elif username == "W.Wright" and password == "thesims": 
printCHow goes it, Will?") 
security = 3 

elif username == "guest" or password == "guest": 
print("Welcome, guest.") 
security = 1 
el se: 

printCLogin failed. You're not so exclusive.\n") 


input( "\n\nPress the enter key to exit.") 
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f \ 

In THE Real World 

If you really wantto implementa private network,you wouldn'twriteusernamesand 
passwords directly into your code. You'd probably use some type of database man- 
agement system (DBMS). Database management Systems allow you to organize, 
access, and updaterelatedinformation.These Systems are powerfulandcouldhandle 
thousands or even millions of pairs of usernames and passwords quickly and 
securely. 


Understanding the not Logical Operator 

I wanted to make sure that the user enters something for the username and password. Just 
pressing the Enter key, which results in the empty string, won’t do. I wanted a loop that 
continues to ask for a username until the user enters something: 

username = 
while not username: 

username = inputCUsername: ") 

In the while condition, I used the logical not operator. It works a lot like the word “not.” In 
English, putting the word “not” in front of something creates a new phrase that means the 
opposite of the original. In Python, putting not in front of a condition creates a new condition 
that evaluates to the opposite of the original. 

This means not username is True when username is Fal se. And not username is False whenuser¬ 
name is True. Here’s another way to understand how not works: 

username not username 
True False 

False True 

Since username is initialized to the empty string in the program, it starts out as False. That 
makes not username T rue and the loop runs the first time. Then, the program gets a value for 
username from the user. If the user just presses Enter, username is the empty string, just as 
before. And just as before, not username is True and the loop keeps running. So, as long as 
the user just hits Enter, the loop keeps running, and the user keeps getting prompted for a 


username. 
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But when the user finally enters something, username becomes something other than the 
empty string. That makes username evaluate to True and not username evaluate to Fal se. As a 
resuit, the loop ends, just like I wanted. 

The program does the same thing for the variable password. 

Understanding the and Logical Operator 

If a member wants to log in to this exclusive network, the member has to enter a username 
and password that are recognized together. If, for example, Sid Meier wants to log in, he has 
to enter S .Meier for his username and ci vi 1 i zati on for his password. If Sid doesn’t enter both, 
just that way, he can’t log in. S.Meier and mariobros won’t work. Neither will M. Dawson and 
ci vi 1 i zati on. The combination civilization and S.Meier fails too. The program checks that 
Sid enters S.Mei er for his username and civilization for his password with the following 
code: 

elif username == "S.Meier" and password == "civilization": 

The line contains a single compound condition made up of two simple conditions. The simple 
conditions are username == "S.Meier" along with password == "ci vi 1 i zati on". These are just 
like conditions youVe already seen, but theyVe been joined together by the and logical 
operator to form a larger, compound condition, username == "S.Meier" and password == 
"civilization". This compound condition, though longer than you’re used to, is stili just a 
condition, which means that it can he either True or False. 

So, when is username == "S.Meier" and password == "civilization" True, and when is it 
False? Well, just like in English, “and” means both. So, the condition is True only if both 
username == "S.Meier" and password == "civi 1 ization" are True; otherwise, it’s False. Here’s 
another way to see how this works: 


username == "S.Meier" password == "civilization" username 

password 

True True True 

True False False 

False True False 

False False False 


"S.Meier" and 
"civilization" 



Put and between two conditions when you want to create a new condition that 
is true onLy if both simpLer conditions are true. 
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So, when Sid enters S.Mei er for his username and civilization for his password, the com- 
pound condition is true. Sid is then greeted and assigned a security level. 

The program, of course, works for others hesides Sid Meier. Through an i f-el i f-el se struc¬ 
ture, the program checks four different username and password pairs. If a user enters a 
recognized pair, the memher is personally greeted and assigned a security value. 

If a memher or guest doesn’t properly log in, the computer prints a “failed login” message 
and telis the person that he or she is not so exclusive. 


Understanding the or Logical Operator 

Guests are allowed in the network, too, hut with a limited security level. To make it easy for 
a guest to try the network, all he or she has to do is enter guest for either the username or 
password. The following lines of code log in a guest: 

elif username == "guest" or password == "guest": 
printCWelcome, guest.") 
security = 1 

The el i f condition, username == "guest" or password == "guest", looks a lot like the other 
conditions, the ones used for the members. But there’s a major difference. The guest condition 
is created by using the logical o r operator. 

A compound condition created with an or is True as long as at least one of the simpler con¬ 
ditions is True. Again, the operator works just like in English. “Or” means either, so if either 
condition is True, the compound condition is True. In this particular case, if username == 
"guest" is True or if password == "guest" is True, or even if both are True, then username == 
"guest" or password == "guest" is True; otherwise, it’s Fal se. Here’s another way to look at 


how or works: 




username == "guest" 

password == "guest" 

username == 

"guest" or 



password == 

"guest" 

True 

True 

True 


True 

Fal se 

True 


False 

True 

True 


False 

Fal se 

False 
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Planning Your Programs 

So far, all the programs you’ve seen have been pretty simple. The idea of planning any of them 
formally on paper probably seems like overkill. It’s not. Planning your programs, even the 
small ones, will almost always resuit in time (and often frustration) saved. 

Programming is a lot like construction. So, imagine a contractor building a house for you 
without a blueprint. Yikes! You’re liable to end up with a house that has 12 bathrooms, no 
Windows, and a front door on the second floor. Plus, it will cost you 10 times the estimated 
price. 

Programming is the same way. Without a plan, youTl likely struggle through the process, 
wasting time. You might even end up with a program that doesn’t quite work. 

Program planning is so important that there’s an entire field of Software engineering dedi- 
cated to it. But even a beginning programmer can benefit from a few simple planning tools 
and techniques. 

Creating Algorithms with Pseudocode 

An algorithm is a set of ciear, easy-to-follow instructions for accomplishing some task. An 
algorithm is like an outline for your program. It’s something you planned out, before pro¬ 
gramming, to guide you along as you code. 

An algorithm isn’t just a goal—it’s a concrete list of steps to be followed in order. So, for 
example, “Be a millionaire” is not really an algorithm. It’s more like a goal. But a worthy one. 
So I wrote the Make a Million Dollars algorithm. Here it is: 

if you can think of a new and useful product 
then thafs your product 
otherwise 

repackage an existing product as your product 
make an infomercial about your product 
Show the infomercial on TV 
charge $100 per unit of your product 
sell 10,000 units of your product 

There you go. It’s a ciear series of finite steps that can be followed to achieve the goal. 

Algorithms are generally written in something called pseudocode, and mine is no exception. 
Pseudocode falis somewhere between English and a programming language. Anyone who 
understands English can understand my algorithm. But at the same time, my algorithm 
should feel vaguely like a program. The first four lines resemble an i f -el se structure, and 
thafs intentional. 
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AppLying Stepwise Refinement to Your Algorithms 

Like any outline or plan, your algorithm might not be finished after one draft. Often, algo¬ 
rithms need multiple passes before they can be implemented in code. Stepwise refinement is 
one process used to rewrite algorithms so that they’re ready for implementation. Basically, 
it means “make it more detailed.” By taking each step in an algorithm and brealdng it down 
into a series of simpler steps, the algorithm becomes closer to programming code. In stepwise 
refinement, you keep breaking down each step until you feel that the entire algorithm could 
be fairly easily translated into a program. As an example, take a step from the Make a Million 
Dollars algorithm: 

create an infomercial about your product 

This might seem like too vague a task. How do you create an infomercial? Using stepwise 
refinement, the single step can be broken down into several others. So, it becomes the 
following: 

write a script for an infomercial about your product 

rent a TV studio for a day 

hi re a productior crew 

hi re an enthusiastic audience 

film the infomercial 

If you feel that these five steps are ciear and achievahle, then that part of the algorithm has 
been thoroughly refined. If you’re stili unclear about a step, refine it some more. Continue 
with this process and you will have a complete algorithm and a million dollars. 

Returning to THE GuESS My Number Game 

The Guess My Number game combines many of the concepts you learned in this chapter. But, 
more importantly, it represents the first full game that you can use to show off to your friends, 
family, and members of the opposite sex. 

Planning the Program 

To plan the game, 1 wrote some pseudocode first: 
pick a random number 

while the player hasn't guessed the number 
let the player guess 
congratulate the player 
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This isn’t a bad first pass, but it’s missing some important elements. First, the program needs 
to teli the player if the guess is too high or too low. Second, the program should keep track 
of how many guesses the player has made and then teli the player this number at the end of 
the game. 

It's okay if your first program pLan isn't complete. Start pLanning with the major 
ideas first, then filL in the gaps untiL it feels done. 



Okay, here’s a refinement of my algorithm: 

welcome the player to the game and explain it 
pick a random number between 1 and 100 
ask the player for a guess 
set the number of guesses to 1 

while the player's guess does not equal the number 
if the guess is greater than the number 
teli the player to guess lower 
otherwise 

teli the player to guess higher 
get a new guess from the player 
increase the number of guesses by 1 
congratulate the player on guessing the number 
let the player know how many guesses it took 

Now 1 feel ready to write the program. Take a look over the next few sections and see how 
directly pseudocode can be translated into Python. You can find the code for this program on 
the companion wehsite, in the Chapter 3 folder; the file name is guess_my_ number.py. 

Creating the Initial Comment Block 

Like all good programs, this one begins with a hlock of comments: 

# Guess My Number 

# 

# The computer picks a random number between 1 and 100 

# The player tries to guess it and the computer lets 

# the player know if the guess is too high, too low 

# or right on the money 
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Importing the random Module 

To be fun, the program needs to generate a random number. So, I imported the random module: 
import random 

Explaining the Game 

The game is simple, but a little explanation wouldnT hurt: 

print( ''\tWel come to 'Guess My Number'!") 

print(''\nrm thinking of a number between 1 and 100.") 

printCTry to guess it in as few attempts as possible.\n") 

Setting the InitiaL Values 

Next, 1 set all the variables to their initial values: 

# set the initial values 
the_number = random.randintd, 100) 
guess = intdnputCTake a guess: ")) 
tries = 1 

the_number represents the number the player has to guess. 1 assign it a random integer from 
1 to 100 with a call to random. randint( ). Next, input( ) gets the player’s first guess. int( ) con- 
verts the guess to an integer. 1 assign this number to guess. 1 assign tries, which represents 
the number of guesses so far, the value 1. 

Creating a Guessing Loop 

This is the core of the program. The loop executes as long as the player hasn’t correctly guessed 
the computer’s number. In the loop body, the player’s guess is compared to the computer’s 
number. If the guess is higher than the number, Lower is printed; otherwise. Hi gher is printed. 
The player enters the next guess, and the number of guesses counter is incremented. 

# guessing loop 

while guess 1= the_number: 
if guess > the_number: 

printC'Lower...") 
else: 

print("Higher...") 

guess = int(input(''Take a guess: ")) 
tries += 1 
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Congratulating the Player 

When the player guesses the numher, guess is equal to the_number, which means that the loop 
condition, guess != the_number, is Fal se and the loop ends. At that point, the player needs to 
he congratulated: 

printCYou guessed it! The number was", the_number) 
printCAnd it only took you", tries, "tries!\n") 

The computer telis the player what the secret numher was and how many tries it took the 
player to guess it. 

Waiting for the Player to Quit 

As always, the last line waits patiently for the player to press the Enter key: 
input( "\n\nPress the enter key to exit.") 

SUMMARY 

In this chapter, you saw how to change the flow of your program. You learned that the key 
to changing the flow is the computer’s ahility to evaluate conditions. You saw how to create 
simple and compound conditions. You learned ahout the i f, if-el se, and i f-el i f-el se state- 
ments, which allow programs to make a decision. You met the wh i 1 e loop, useful for repeating 
code sections. You learned ahout the importance of program planning. You saw how to plan 
a program hy creating an algorithm in pseudocode. You also learned how to generate random 
numhers to add some excitement to your programs. 
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Challenges 

1. Write a program that simulates a fortune cookie. The program 
should display one of five unique fortunes, at random, each 
time it's run. 

2. Write a program that flips a coin f 00 times and then telis you 
the number of heads and tails. 

3. Modify the Guess My Number game so that the player has a 
limited number of guesses. If the player fails to guess in time, 
the program should display an appropriately chastising 
message. 

4. Here's a bigger challenge. Write the pseudocode for a program 
where the player and the computer trade places in the number 
guessing game. That is, the player picks a random number 
between I and f 00 that the computer has to guess. Before you 
start,thinkabouthow you guess. If allgoes well, try codingthe 
game. 
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FOR Loops, Strings, and 
Tuples: The Word 

JUMBLE GaME 


Y ou’ve seen howvariables are a great way to access information, but as your 
programs grow in size and complexity, so can tbe number of your vari- 
ables. Keeping track of all of tbem can become a lot of work. Tberefore, in 
tbis cbapter, you’11 learn about tbe idea of sequences and meet a new type, called 
tbe tuple, wbicb let’s you organize and manipulate information in ordered groups. 
You’11 also see bow a type you’ve already encountered, tbe string, is really a 
sequence too. You’11 learn about a new Idnd of loop tbafs built just for working 
witb sequences. Specifically, you’11 learn bow to do tbe following: 

• Construet fo r loops to move tbrougb a sequence 
• Use tbe range( ) function to create a sequence of numbers 
• Treat strings as sequences 
• Use tuples to barness tbe power of sequences 
• Use sequence functions and operators 
• Index and slice sequences 

InTRODUCING THE WORD JuMBLE GaME 

Tbe Word Jumble game, featured in Figure 4.1, utilizes many of tbe new ideas 
you’11 learn in tbis cbapter. 
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The WordJumble 
Looks “difficuLt." 

This game re-creates the typical word jumble you might find in the Sunday paper (you know, 
that thing people used to read before the Internet). The computer picks a random word from 
a group and then creates a jumbled version of it, where the letters are in random order. The 
player has to guess the original word to win the game. 


USING FOR LOOPS 


In the last chapter, you saw one kind of loop, the wh i 1 e loop, which repeats part of your code 
based on a condition. As long as the condition is true, some code repeats. The for loop also 
repeats code, but not based on a condition. Instead, the for loop repeats part of a program 
based on a sequence, an ordered list of things. If you’ve ever written a list of, say, your top 10 
favorite movies, then youVe created a sequence. 

A for loop repeats its loop body for each element of the sequence, in order. When it reaches 
the end of the sequence, the loop ends. As an example, consider your movie list sequence 
again. A for loop couid go through this sequence of movie tities, one at a time, and print each 
one. But the best way to understand a for loop is to see one in action. 

Introducing the Loopy String Program 

This program takes a word from the user and prints its letters, in order, on separate lines. 
Look at a sample run in Figure 4.2. 
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A for Loop goes 
through a word 
the User enters, 
one character at a 
time. 


This simple program provides a good example of a for loop. You can find the code for the 
program on the companion website (www.courseptr.com/downloads) in the Chapter 4 folder; 
the file name is loopy_string.py. 

# Loopy String 

# Demonstrates the for loop with a string 

word = inputCEnter a word: ") 

print("\nHere's each letter in your word:") 
for letter in word: 
pri ntd etter) 

input(''\n\nPress the enter key to exit.") 

Understanding for Loops 

The new idea in this program is the f o r loop, which is just the following two short lines: 

for letter in word: 
pri ntd etter) 

Even hefore you know an 5 d:hing about for loops, the code is pretty ciear, but ITl explain exactly 
how it Works. All sequences are made up of elements. A string is a sequence in which each 
element is one character. In the case of the string "Loop", the first element is the character 
" L", the second is " o", and so on. 
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A f 0 r loop marches through (or iterates over) a sequence one element at a time. In my program, 
the loop iterates over the string " Loop ", one character at a time. A f o r loop uses a variahle that 
gets each successive element of the sequence. In my loop, 1 etter is the variahle that gets each 
successive character of "Loop". Inside the loop body, the loop can then do something with 
each successive element. In my loop body, I simply print 1 etter. Now, the variahle you use to 
get each element of the sequence is like any other variahle—and if it doesn’t exist before the 
loop, it’s created. 

So, when my loop begins, 1 etter is created and gets the first character in word, which is " L". 
Then, in the loop body, the print statement displays L. Next, with the loop body finished, 
control jumps back to the top of the loop and 1 etter gets the next character in word, which 
is "o". The computer displays o, and the loop continues until each character in the string 
" Loop" is displayed. 


/ \ 

In THE Real World 

Most modern languages offeraform of the for loop. However, these loops tend to be 
more restrictive. The loops generally only allow a counter variahle, which must be 
assigned a number. Then, the counter changes by the same amount, each time the 
loop executes. The ability to loop directly through a sequence makes the Python 
for loop more flexible than this other, more traditional type of loop. 


Creating a for Loop 

To create a for loop, you can follow the example in the program. Start with for, followed by 
a variahle for each element, followed by in, followed by the sequence you want to loop 
through, followed by a colon, and finally, the loop body. Thafs all there is to it. 

COUNTING WITH A FOR LoOP 

When you write a program, you may find that you need to count. In combination with the 
for loop, you can use Python’s range( ) function to count in all Idnds ofways. 

Introducing the Counter Program 

The Counter program is nothing fancy, but it shows you how to use the r a n g e () function with 
a for loop to count forwards or backwards, or even to skip numbers if you like. Take a look 
at Figure 4.3 to see the results of the program. 
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^ Figure4.3 ^ 

The range() 
function and for 
Loop alLow you to 
countforwards, by 
fives, and 
backwards. 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 4 folder; the file name is counter.py. 

# Counter 

# Demonstrates the rangeO function 

printCCounting:") 
for i in range(lO): 
print(i, end='' ") 

print( ''\n\nCounting by fives:") 
for i in range(0, 50, 5): 
print(i, end=" ") 

pri nt( ''\n\nCounti ng backwards:") 
for i in rangedO, 0, -1): 
print(i, end=" ") 


input(''\n\nPress the enter key to exit.\n") 
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In THE Real World 

lt's traditional to name generic counter and loop variables i, j, or k. Normally, you 
want to create descriptive, ciear variable names. Believe it or not, 1, j, and k are ciear 
to experienced programmers, who know when reading your code that you just need 
a quick, counter variable. 


Counting Forwards 

The first loop in the program counts forwards: 

for i in range(lO): 

printd, end='' ") 

This for loop works like the for loop you saw in the Loopy String program. But this time, the 
sequence the loop iterates over is generated by the return value of the range( ) function. You 
can imagine that the range( ) function returns a sequence of numbers. If you give range( ) a 
positive integer, you can imagine that it returns a sequence starting with 0, up to, but not 
including, the number you gave it. So, you can imagine that the code range (10) returns the 
sequence [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]. This should help you visualize what happens in 
the loop: in the first iteration of the loop, i gets 0 and its value is printed, then, in the next 
iteration, i gets 1 and its value is printed and so on until the final iteration, where i gets 9, 
its value is printed, and the loop ends. 

WhiLe it can be helpfuL to imagine that the resuit of the range () function is a 
sequence of integers, that's not what it produces. The function actualLy returns 
something that produces the next number in the sequence, as needed. For our 
purposes, imagining the entire sequence of numbers alL at once is fine. If you 
want to Learn more about the inner workings of the range () function, check out 
the documentation at http://www.python.org. 

You can create your own sequence of vaLues, caLLed a List, by encLosingthe vaLues 
in brackets, separated by commas. But don’t go off creating a bunch of Lists just 
yet. YoulL Learn aLL about Lists in Chapter 5, "Lists and Dictionaries: The Hangman 
Game," I promise. 
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Counting by Fives 

The next loop counts by fives: 

for i in range(0, 50, 5): 
printd, end=" ") 

If you give range() three values, it will treat them as a start point, an end point, and the 
number by which to count. The start point is always the first value in our imagined sequence 
while the end point is never included. So here, our imagined sequence is [0, 5, 10, 15, 20, 
25, 30, 35, 40, 45]. Notice though that the sequence ends at 45. Remember, 50 is the end 
point, so it’s not included. If you want to include 50, your end point needs to be greater than 
50. So, for example, range(0, 51, 5) would do the trick. 

Counting Backwards 

The last loop in the program counts backwards: 

for i in rangedO, 0, -1): 
printii, end=" ") 

It does this because the last argument in the range( ) call is -1. This telis the function to go 
from the start point to the end point by adding -1 each time. This is the same as saying 
“subtract 1.” You can imagine the call to range( ) produces the sequence [10, 9, 8, 7, 6, 5, 
4, 3, 2, 1]. So, the loop counts from 10 down to 1 and does not include 0. 

There's no Law that saysyou have to use the Loop variabLe inside a for Loop. You 
might find that you want to repeat some action a specific number of times. To 
do this, create a for Loop and just ignore the Loop variabLe in the Loop body. For 
exampLe, Let's say I just wanted to print "Hi !" 10 times. The foLLowing two Lines 
are aLL I wouLd need: 

for i in range(lO): 
print("Hi!") 

UsiNG Sequence Operators and Functions with Strings 

As you just learned, strings are one t 5 rpe of sequence, made up of individual characters. Python 
offers some useful functions and operators that work with any kind of sequence, including 
strings. These operators and functions can teli you basic but important things about a 
sequence, such as how long it is or whether a certain element is in it. 
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Introducing the Message Analyzer Program 

This next program analyzes any message that you enter. It telis you how long the message is 
and whether or not it contains the most common letter in the English language (the letter 
“e”). The program accomplishes this with a new sequence function and sequence operator. 
Figure 4.4 shows off the program. 


Q Figure4.4 ^ 

This program uses 
the len() 
function and the 
1 n operator to 
produce some 
Information about 
your message. 


^J^itf’ython31 \python.exe HEID 

Hntei» a message: Gane Ouer? Q 

The length of your message is: 10 f 

The most common letter in the English language, 'e', 
is in your message. 

Press the enter key to exit. 


You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 4 folder; the file name is message_analyzer.py. 

# Message Analyzer 

# Demonstrates the lenO function and the in operator 
message = inputCEnter a message: ") 

print("\nThe length of your message is:", 1en(message)) 

print("\nThe most common letter in the English language, 'e',") 
if "e" in message: 

printCis in your message.") 
el se: 

printCis not in your message.”) 


input( "\n\nPress the enter key to exit.") 
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Usingthe Len() Function 

After the program imports the random module and gets the user’s message, it prints the mes- 
sage length with 

print( ''\nThe length of your message is:", 1 en(niessage)) 

You can pass any sequence you want to the 1 en () function and it will return the length of the 
sequence. A sequence’s length is the numher of elements it has. Since message has 10 charac- 
ters in it (you count every character, including a space or an exclamation point), it has a length 
of 10. 

Using the in Operator 

The letter “e” is the most common letter in English. The program uses the following lines to 
test whether “e” is in the message the user entered: 

if "e" in message: 

printCis in your message.") 
else: 

printCis not in your message.") 

The condition in the if statement is "e" in message. If message contains the character "e", it’s 
true. If message doesnT contain "e", it’s false. In the sample run, the value of message is "Game 
Over !", which does contain the character "e". So, the condition "e" in message evaluated to 
True and the computer printed "is in your message." If the condition had been false (for 
example, if message had been equal to " Python Programmi ng"), then the computer would have 
displayed is not in your message. If an element is in a sequence, it’s said to be a member of 
the sequence. 

You can use i n anywhere in your own programs to check if an element is a member of a 
sequence. Just put the element you want to check for, followed by in, followed by the 
sequence. This creates a condition. If the element is a member, the condition is true; other- 
wise, it’s false. 

Indexing Strings 

By using a for loop, you’re able to go through a string, one character at a time, in order. This 
is known as sequential access, which means you have to go through a sequence one element at 
a time. Sequential access is like going through a stack of heavy boxes that you can only lift 
one at a time. To get to the bottom box in a stack of five, you’d have to lift the top box, then 
the next box, followed by the next box, then one more to finally get to the last box. WouldnT 
it be nice to just grab the last box without messing with any of the others? This kind of direct 
access is called random access. Random access allows you to get to any element in a sequence 
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directly. Fortunately, there’s a way to randomly access elements of a sequence. It’s called 
indexing. Through indexing, you specify a position (or index) number in a sequence and get 
the element at that position. In the box example, you could get the bottom box directly by 
asking for box number five. 

Introducing the Random Access Program 

The Random Access program uses sequence indexing to directly access random characters in 
a string. The program picks a random position from the string "i ndex", and prints the letter 
and the position number. The program does this 10 times to give a good sampling of random 
positions. Figure 4.5 shows the program in action. 


^ Figure4.5 ^ 

You can directLy 
access any 
character in a 
string through 
indexing. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 4 folder; the file name is random_access.py. 

# Random Access 

# Demonstrates string indexing 
import random 

word = "index" 

printCThe word is: ", word, "\n") 

high = len(word) 
low = -len(word) 
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for i in range(lO): 

position = random.randrangedow, high) 
print("word[", position, "]\t", wordLposition]) 

input("\n\nPress the enter key to exit.") 

Working with Positive Position Numbers 

In this program, one of the first things I do is assign a string value to a variable: 
word = "index" 

Nothing new here. But by doing this, I create a sequence (like every time I create a string) 
where each character has a numbered position. The first letter, “i,” is at position 0. (Remem- 
ber, computers usually start counting from 0.) The second letter, “n,” is at position 1. The 
third letter, “d,” is at position 2, and so on. 

Accessing an individual character of a sfring is easy. To access fhe letter in position 0 from 
the variable word, you’d just type word[0]. For any other position, you’d just substitute that 
number. To help cernent the idea, take a look at part of an inferacfive session I had: 

>>> word = "index " 

>>> print(word[0]) 
i 

>>> print(word[l]) 
n 

>>> print(word[2]) 
d 

>>> print(word[3]) 
e 

>>> print(word[4]) 

X 



Since there are five Letters in the string " i ndex", you might think that the Last 
Letter, "x," wouLd be at position 5. Butyou'd be wrong. There is no position 5 in 
this string, because the computer begins counting at 0. VaLid positive positions 
are 0, 1,2, 3, and 4. Any attempt to access a position 5 wiLL cause an error. Take a 
Look at an interactive session for proof: 

»> word = "index " 

>>> print(word[5]) 

Traceback (most recent call last): 

File "kpyshel1#1>", line 1, in ? 
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print word[5] 

IndexError: string index out of range 

Somewhat rudeLy, the computer is saying there is no position 5. So remember, 
the Last eLement in a sequence is at the position number of its Length minus one. 


Working with Negative Position Numbers 

Except for the idea that the first letter of a string is at position 0 and not 1, worldng with 
positive position numbers seems pretty natural. But there’s also a way to access elements of 
a sequence through negative position numbers. With positive position numbers, your point 
of reference is the beginning of the sequence. For strings, this means that the first letter is 
where you start counting. But with negative position numbers, you start counting from the 
end. For strings, that means you start counting from the last letter and work backwards. 

The best way to understand how negative position numbers work is to see an example. Take 
a look at another interactive session 1 had, again, using the string " index ": 

»> Word = "index " 

>» print(word[-l]) 

X 

>» print(word[-2]) 
e 

>» print(word[-3]) 
d 

>» print(word[-4]) 
n 

>» print(word[-5]) 
i 

You can see from this session that word[-l] accesses the last letter of "index", the “x.” When 
using negative position numbers, -1 means the last element, the index -2 means the second 
to the last element, the index -3 means the third to the last element, and so on. Sometimes 
it makes more sense for your reference point to be the end of a sequence. For those times, you 
can use negative position numbers. 

Figure 4.6 provides a nice way to see the string " i ndex" broken up by position numbers, both 
positive and negative. 
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Q Figure4.6 ^ 

You can access any 
Letter of " 1 ndex" 
with a positive or 
negative position 
number. 


Accessing a Random String Element 

It’s time to get back to the Random Access program. To access a random letter from the 
"index", I need to generate random numbers. So, the first thing I did in the program was 
import the random module: 

import random 

Next, I wanted a way to pick any valid position number in word, negative or positive. I wanted 
my program to be able to generate a random number between -5 and 4, inclusive, because 
those are all the possible position values ofword. Luckily, the random. randrange( ) function can 
take two end points and produce a random number from between them. So, I created two 
end points: 

high = len(word) 
low = -len(word) 

high gets the value 5, because " i ndex " has five characters in it. The variable 1 ow gets the neg¬ 
ative value of the length of the word (thafs what putting a minus sign in front of a numeric 
value does). So 1 ow gets the value of-5. This represents the range from which I want to grab 
a random number. 

Actually, I want to generate a random number between, and including, -5 up to, but not 
including, 5. And thafs exactly the way the random. randrange( ) function works. Ifyou pass it 
two arguments, it will produce a random number from and including the low end point, up 
to, but not including, the high end point. So in my sample run, the line. 

position = random.randrangedow, high) 

produces either -5, -4, -3, -2, -1, 0, 1, 2, 3, or 4. This is exactly what 1 want, since these are 
all the possible valid position numbers for the string "i ndex". 

Finally, 1 created a for loop that executes 10 times. In the loop body, the program picks a 
random position value and prints that position value and corresponding letter: 

for i in range(lO): 

position = random.randrangedow, high) 
print("word[", position, "]\t", wordLposition]) 
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Understanding String Immutability 

Sequences fall into one of two categories: mutable or immutable. (Again, more fancy com¬ 
puter jargon.)MutaWe means changeable. So, a sequence thafs a mutable sequence is one that 
can change. Immutable means unchangeable. So, a sequence thafs immutable is one that can’t 
change. Strings are immutable sequences, which means that they can’t change. So, for exam- 
ple, the string "Game Over! " will always he the string "Game Over! You can’t change it. in 
fact, you can’t change any string you create. Now, you might think, from your experience 
with strings, that i’m totally wrong on this. You might even run an Interactive session to prove 
that you can change a string, maybe something resembling this: 

>» nane = "Chris " 

>» print(nanie) 

Chri s 

>» name = "Jackson " 

>>> print(nanie) 

Jackson 

You might offer this as proof that you can change a string. After ali, you changed the string 
"Chris" to "Jackson ". But, you didn’t change any strings in this session. You just created 
two different strings. First, you created a string "Chris " and assigned it to the variable 
name. Then, you created another string, "Jackson ", and assigned it to name. Now, hoth “Chris” 
and “Jackson” are great names, but they’re different names and always will be, just as they 
are different strings and always will he. Take a look at Figure 4.7 for a visual representation 
of what happened in the interactive session. 




First, name gets the 
string "Chri s", 
then it gets a 
different string. 


"Jackson". But no I_ 

string values ever 
change. 

Another way to think about this is to imagine that strings are written in ink on pieces of 
paper. You can throw out a piece of paper with a string on it and replace it with another piece 
of paper with a new string on it, but you can’t change the words once theyVe heen written. 


You might think this is much ado about nothing. So what if a string is immutable? But string 
immutability does have consequences. Since you can’t change a string, you can’t assign a new 
character to a string through indexing. Here’s an interactive session to showyou what 1 mean: 
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>>> word = "game " 

»> word[0] = "1 " 

Traceback (most recent call last): 

File "<pyshel1#1>", line 1, in <module> 
wordLO] = "1" 

TypeError: 'str' object does not support item assignment 

In this session, I wanted to change the string "game" to the string "1 ame" (obviously, I didn’t 
much like the game I was referring to). All I needed to do was change the letter “g” to an “1.” 
Soljustassigned "1 " to the first position in the string, word [OJ.But as youcansee, this resulted 
in a big, fat error. The interpreter even telis me that strings don’t support item assignment 
(you can’t assign a new value to a character in a string). 

But, just because you can’t alter a string doesn’t mean you can’t create new strings from 
existing ones. 

Building a New String 

YouVe already seen how you can concatenate two strings with the + operator. Sometimes, 
you may want to build a new string, one character at a time. Since strings are immutable, 
what youTl really be doing is creating a new string every time you use the concatenation 
operator. 

Introducing the No Vowels Program 

This next program. No Vowels, takes a message from the user and prints it, minus any vowels. 
Figure 4.8 shows the program in action. 
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The program creates a new string of the original message, without the vowels. Really what 
it does is create a series of new strings. You can find the code for the program on the com- 
panion wehsite (www.courseptr.com/downloads) in the Chapter 4 folder; the file name is 
no_vowels.py. 

# No Vowels 

# Demonstrates creating new strings with a for loop 

message = inputCEnter a message: ") 
new_niessage = 

VOWELS = "aeiou" 

pri nt() 

for letter in message: 

if letter.lower() not in VOWELS: 
new_message += letter 

printCA new string has been created:", new_message) 
print( "\nYour message without vowels is:", new_message) 
input( "\n\nPress the enter key to exit.") 

Creating Constants 

After the program gets the message from the user and creates an empty new message, it 
creates a string: 

VOWELS = "aeiou" 

This variable, VOWELS, gets a string of all the vowels. You probably notice that the variable 
name is in all caps, contrary to what you have learned: that, traditionally, variable names are 
in lowercase. Well, 1 haven’t veered from tradition here. In fact, there’s a special meaning 
associated with variable names in all caps. They’re called constants and refer to a value that is 
not meant to change (their value is constant). 

Constants are valuable to programmers in two ways. First, they make programs clearer. In 
this program, 1 can use the variable name VOWELS an 5 where 1 need the sequence of vowels, 
instead of the string "aeiou". Using the variable name instead of the string is clearer. When 
you see the variable name, you understand what it means, but you might be confused by 
seeing the odd-looking string itself. Second, constants save retyping (and possibly errors from 
mistyping). Constants are especially useful if you have a long value, like a very long number 
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or string. Use a constant in programs where you have the same, unchanging value used in 
multiple places. 



You have to be carefuL when you create constants by making an aLL-caps variabLe 
name. Even though you're saying to yourseLf and other programmers that this 
variabLe wiLL aLways refer to the same vaLue, there's nothing in Python that wiLL 
stop you from changing it in your program. This naming practice is simpLy a con- 
vention. So, onceyou create a variabLe with a name in aLL caps, make sure to treat 
it as unchangeabLe. 


/ \ 

In THE Real World 

In some programming languages, constants are exactly that. They can't be changed 
once they're defined. That's the safest way to create and use constants. In Python, 
though, there isn't a simple way to create true constants of your own. 


Creating New Strings from Existing Ones 

The real work of the program happens in the loop. The program creates a new message, with- 
out any vowels, as the loop runs. Each time through, the computer checks the next letter in 
the original message. If it’s not a vowel, it adds this letter to the new message it’s creating. If 
it is a vowel, the program moves on to the next letter. You know that a program can’t literally 
add a character to a string, so, more precisely, when the program comes across a character 
thafs not a vowel, it concatenates the new message it has so far with this character to create 
a new string. The code that accomplishes this is: 

for letter in message: 

if 1etter.1ower() not in VOWELS: 
new_message += letter 

printCA new string has been created:", newjessage) 

There are two new ideas in the loop, so let me go over hoth of them. First, I^thon is picky 
when dealingwith strings and characters. "A" is not the same as "a". Since VOWELS is assigned 
a string that contains only lowercase letters, 1 needed to make sure that 1 checked only low- 
ercase letters when usingthe in operator. Thafs why 1 used 1 etter. 1 ower(). 
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Often, when you compare two strings, you don't care about the case matching, 
onLy the Letters. If you ask a pLayer if he or she wants to continue a game, the 
string " Yes " is asgood as the string "yes WeLL, in these instances, just make sure 
to convert both strings to the same case (upper- or Lowercase, it doesn't matter) 
before you compare them. 


Here’s an example. Let’s say I want to compare two strings, name and wi nner, to see if they are 
equal, and I don’t care about matching the case. I could create the condition: 

name.lowerO == winner.1ower() 

This condition is true whenever name and wi nner each have the same sequence of characters, 
regardless of case. So, "Larry" and "larry" is a match. "LARRY" and "larry" is too. Even 
"LaRrY" and "lArRy" works. 

Second, you also might notice that I used the augmented assignment operator, +=, in the 
program for string concatenatiori. You saw the augmented assignment operators with num- 
hers, but they also work with strings. So, this line: 

new_message += letter 

is exactly the same as 

new_message = new_message + letter 

Slicing Strings 

Indexing is a useful technique, but you aren’t restricted to copying just one element at a time 
from a sequence. You can make copies of continuous sections of elements (called slices). You 
can copy (or slice) one element (just like indexing) or part of a sequence (like, say, the middle 
three elements). You can even create a slice that is a copy of the entire sequence. So, for strings, 
that means you can grab anything ranging from a single character, to a group of consecutive 
characters, to the entire string. 

Introducing the Pizza SLicer Program 

The Pizza Slicer program lets you slice the string "pizza" any way you want. lt’s a great, 
interactive way to help you understand slicing. All you do is enter the starting and ending 
positions of the slice, and the program displays the results. Figure 4.9 shows off the program. 
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m C:\Python31\python.exe 


HEID 


Slicing 'Cheat Sheet' 
0 12 3 4 5 


♦- 4- -+- 4- -+-+ 


♦- 4- - 4- - 4- --+ 


-4 -3 -2 -1 


l-iitei* the beginning and ending index for your slice of 
[l‘ress the enter key at 'Begin' to exit. 


Start: 0 
Finish: 5 

v^urdC 0 : 5 3 is pizza 


Start: -5 
Finish: 5 

viordC -5 : 5 3 is pizza 


Rtart: -5 
Finish: -1 
unrdC -5 : -1 3 



Start: 4 
Finish: 5 
v^o rd[ 4 : 5 


IStart: 0 
Finish: 2 
K^ordt 0:2 


3 is pi 


IStart: -5 
Finish: 2 
rdt -5 : 2 


3 is pi 


Start: . 


Fresh, hot sLices of 
”pi zza", made 
justthe way you 
asked. The 
program aLso 
offers a "cheat 
sheet" so you can 
visuaLize how a 
sLIce wiLL be 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 4 folder; the file name is pizza_slicer.py. 

# Pizza SIicer 

# Demonstrates string slicing 
word = "pizza" 


print( 

II II II 

Slicing 'Cheat Sheet' 

0 1 2 3 4 5 

+. .. .+ 

I P I H z I z I a I 

+. . .+. .. .+. . .+ 

-5 -4 -3 -2 -1 


) 
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printCEnter the beginning and ending index for your slice of 'pizza'.") 
printCPress the enter key at 'Start' to exit.") 
start = None 
while start != 

start = (input( "\nStart: ")) 

if start: 

start = int(start) 

finish = int(input("Finish: ")) 

print("wordL", start, ":", finish, "] is", end=" ") 
print(word[start:finish]) 

input( "\n\nPress the enter key to exit.") 

Introducing None 

Before you get to the code about slicing, take a look at this line, which introduces a new idea: 
start = None 

The line assigns a special value, called None, to start. None is Python’s way of representing 
nothing. None makes a good placeholder for a value. It also evaluates to Fal se when treated 
as a condition. 1 used it here because 1 wanted to initialize start for use in the while loop 
condition. 

Understanding Slicing 

Creating a slice is similar to indexing. But instead of using a single position number, you 
supply a starting position and ending position. Every element between the two points 
becomes part of the slice. Figure 4.10 shows a way to look at slicing end point numbers for 
the string "pi zza". Notice that it’s a slightly different numbering system than the indexnum- 
bering in Figure 4.6. 

To specify the end points of a slice, include both in brackets, separated by a colon. Here’s a 
quick Interactive session to showyou what 1 mean: 
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Q Figure4.io ^ 

An exampLe of 
slicing end point 
numbers for the 
string ”pizza 
You can use any 
combination of 
positive and 
negative end 
points foryour 
sLice. 


0 1 2 3 4 5 


•5 -4 -3 -2 -1 


>>> word = "pizza" 

>>> print(word[0:5]) 
pi zza 

>>> print(word[l:3]) 
i z 

>>> print(word[-4:-2]) 
i z 

>>> print(word[-4:3]) 
i z 


wo r d [ 0 : 5 ] returns the entire string because all its characters are between those two end points. 
word[l :3] returns the string "iz" because those two characters are between the end points. 
Just like with indexing, you can use negative numbers. word [ -4: - 2] also produces the string 
"i z" because those characters are between the two negative positions. You can also mix and 
match positive and negative end points. This works just like creating any other slice; the 
elements between the two position numbers will be in the slice. So, word[ -4: 3] also produces 
the string "i z", because they are the two characters between those two end points. 



If you create an "impossibLe" slice, where the starting point is bigger than the 
ending point, Like word [2 : 1 ],youwon'tcausean error. Instead, Python wiLLquietLy 
return an empty sequence. For strings, that means youlL get the empty string. 
So be carefuL, because this is probabLy not the kind of resuityou're after. 


Creating Slices 

Inside the loop of Pizza Slicer, the program prints the S 5 mtax for creating a slice based on the 
beginning and ending positions the user entered, through the following line: 

printCwordl", start, finish, "] is", end=" ") 
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Then, the program prints the actual slice using the variables start and f i ni sh: 
print(word[start:finish]) 

Using Slicing Shorthand 

Although you can get every possible slice by specifying two numbers, there are a few slicing 
shortcuts you can use. You can omit the beginning point for the slice to start the slice at the 
beginning of the sequence. So, given that word has been assigned "pizza", the slice word[ :4] 
is exactly the same as word[0:4]. You can omit the ending point so that the slice ends with 
the very last element. So, word[2 : ] is just shorthand for word[2 : 5]. You can even omit both 
numbers to get a slice that is the entire sequence. So, word[ : ] is shorthand for word[0:5]. 

Here’s an interactive session to back up this proposition: 

>» word = "pizza" 

>»print(word[0:4]) 

pizz 

>»pri nt(word[ :4]) 
pizz 

>»print(word[2:5]) 

zza 

>»print(word[2:]) 

zza 

>>>print(word[0:5]) 

pizza 

>» print(word[: ]) 

Pizza 

If there's one bit of slicing shorthand you shouLd remember, it's that [: ] returns 
a complete copy of a sequence. As you program, youllfind you may need to make 
a copy of a sequence, and this is a quick and efficient way to do just that. 


Creating TupLes 

Tuples are a type of sequence, like strings. But unlike strings, which can only contain char- 
acters, tuples can contain elements of any type. That means you can have a tuple that Stores 
a bunch of high scores for a game, or one that Stores a group of employee names. But tuple 
elements don’t have to all be of the same type. You could create a tuple with both strings and 
numbers, if you wanted. And you don’t have to stop at strings and numbers. You can create 
a tuple that contains a sequence of graphic images, sound files, or even a group of aliens (once 
you learn how to create these things, which you will in later chapters). Whatever you can 
assign to a variable, you can group together and store as a sequence in a tuple. 
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Introducing the Hero's Inventory Program 

Hero’s Inventory maintains the inventory of a hero from a typical role-pla 5 dng game. Like 
most role-playing games ever created, the hero is from a small, insignificant village. His father 
was, ofcourse, killed hy an evil warlord. (Whafs a quest without a dead father?) And now that 
the hero has come of age, it’s time for him to seek his revenge. 

In this program, the hero’s inventory is represented hy a tuple. The tuple contains strings, 
one for each item in the hero’s possession. The hero starts out with nothing, hut then I give 
him a few items. Figure 4.11 shows the humhie heginnings of our hero’s journey. 


| [c^ C:\Python31\python.exe 


Vou are enpty-hnndetl. 

'Press the enter key to continue. 


|The tuple inventory is: 

<*sword*, 'armor*, 'shield', 'healing potion'> 


HEID 


|Vour items: 

Word 

[armor 

hield 

healing potion 



Press the enter key to exit._ 


At first, the hero 
has no Items in his 
inventory. Then, 
the program 
creates a new 
tupLe with string 
eLements and our 
hero is stocked. 


You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 4 folder; the file name is hero's_inventory.py. 

# Hero's Inventory 

# Demonstrates tuple creation 

# create an empty tuple 
inventory = () 

# treat the tuple as a condition 
if not inventory: 

printCYou are empty-handed.") 


input("\nPress the enter key to continue.") 
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# create a tuple with some items 
inventory = ("sword", 

"armor", 

"shield", 

"healing potion") 

# print the tuple 
print("\nThe tuple inventory is:") 
print(inventory) 

# print each element in the tuple 
print( "\nYour items:") 

for item in inventory: 
print(item) 

input( "\n\nPress the enter key to exit.") 

Creating an Empty Tuple 

To create a tuple, you just surround a sequence of values, separated by commas, with paren¬ 
theses. Even a pair of Ione parentheses is a valid (hut empty) tuple. 1 created an empty tuple 
in the first part of the program to represent that the hero has nothing: 

inventory = () 

lt’s as simple as that. So in this line, the variable i nventory gets an empty tuple. 

Treating a Tuple as a Condition 

When you learned about conditions, you saw that you could treat any value in Python as a 
condition. That means you can treat a tuple as a condition, too. And thafs what 1 did in the 
next lines: 

if not inventory: 

printCYou are empty-handed.") 

As a condition, an empty tuple is Fal se. A tuple with at least one element is True. Since the 
tuple assigned to inventory is empty, it’s False. That means not inventory is True. So the 
computer prints the string, "You are empty-handed. ", just as it should. 
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Creating a TupLe with ELements 

An unarmed hero is a boring hero. So next, I created a new tuple with string elements that 
represent useful items for our hero. I assigned this new tuple to i nventory with the following: 

inventory = ("sword", 

"armor", 

"shield", 

"healing potion") 

Each element in the tuple is separated hy a comma. That makes the first element the string 
"sword", the next "armor", the next "shiel d", and the last element "heal ing potion". So each 
string is a single element in this tuple. 

Also, notice that the tuple spans multiple lines. You can write a tuple in one line, or span it 
across multiple lines like 1 did, as long as you end each line after a comma. This is one of the 
few cases where Python lets you hreak up a statement across multiple lines. 

Make your programs easier to read by creating tuples across multiple lines. You 
don't have to write exactly one element per line, though. It might make sense to 
write several on a line. Just end each line at one of the commas separating ele¬ 
ments and youTl be fine. 



Printing a Tuple 

Though a tuple can contain many elements, you can print the entire tuple just like you would 
any single value. Thafs what 1 did in the next line: 

print("\nThe tuple inventory is:") 
print(inventory) 

The computer displays all of the elements, surrounded by parentheses. 

Looping Through a Tuple's Elements 

Finally, 1 wrote a for loop to march through the elements in inventory and print each one 
individually: 

print( "\nYour items:") 
for item in inventory: 
print(item) 

This loop prints each element (each string) in i nventory on a separate line. This loop looks 
just like the ones youVe seen with strings. In fact, you can use this Idnd of loop to go through 
the elements of any sequence. 
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Even though I created a tuple where all the elements are of the same type (strings in this case), 
tuples don’t have to be filled with values of the same type. A single tuple can just as easily 
contain strings, integers, and floating-point numbers, for example. 



Other programming Languages offer structores simiLar to tupLes. Some go by the 
name "arrays" or "vectors." However, those other Languages usuaLLy restrict the 
elements of these sequences to just one type. So, for example, you couLdn't mix 
strings and numbers together. Just be aware that these other structores don't 
usuaLLy offer all the flexibiLity that Python sequences do. 


UsiNG Tuples 

Since tuples are simply another kind of sequence, everything you learned about sequences 
from strings works with tuples. You can get the length of a tuple, print each element with a 
for loop, and use the i n operator to test if an element is in a tuple. You can index, slice, and 
concatenate tuples, too. 

Introducing the Hero's Inventory 2.0 

Our hero’s journey continues. In this program, his inventory is counted, tested, indexed, and 
sliced. Our hero will also happen upon a chest with items in it (represented by another tuple). 
Through tuple concatenation, our hero’s inventory will be replaced with all of his current 
items plus the treasure he finds in the chest. Figure 4.12 shows a sample run of the program. 



The heros 


inventory is a 
tupLe, which 
means it can be 
counted, indexed, 
sliced, and even 
concatenated with 
another tuple. 


||^C:\Python31 \python.exe 


HEID 


Vout* items: 

woi*d 
ai»mot» 
hie Id 

bealing potion 


Press the enter key to continue. 

Vou have 4 items in your possession. 


Press the enter key to continue. 

Vou will live to fight another day. 


Pnter the index number for an item in inventory: 1 
l^t index 1 is armor 


Hnter the index number to begin a slice: 2 
Enter the index number to end the slice: 4 
inventory! 2 : 4 ] is <'shield', 'healing potion'> 


Press the enter key to continue. 

Vou find a chest. It contains: 

<’gold', 'gems'> 

Vou add the contents of the chest to your inventory. 
Vour inventory is now: 

<’sword*. 'armor', 'shield', 'healing potion', 'gold'. 


'gems') 


Press the enter key to exit. 
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Since this program is a little long, Fll go through the code one section at a time rather 
than Show you the whole thing at once. You can find the code for the program on the com- 
panion website (www.courseptr.com/downloads) in the Chapter 4 folder; the file name is 
hero's_inventory2.py. 

Setting Up the Program 

The first part of the program works just like it did in the previous program, Hero’s Inventory. 
These lines create a tuple and print out each element: 

# Hero's Inventory 2.0 

# Demonstrates tuples 

# create a tuple with sone items and display with a for loop 
inventory = ("sword", 

"armor", 

"shield", 

"healing potion") 
printCYour items:") 
for item in inventory: 
print(item) 

input("\nPress the enter key to continue.") 

Using the len() Function with Tuples 

The 1 en () function works with tuples just the way it does with strings. If you want to know 
the length of a tuple, place it inside the parentheses. The function returns the number of 
elements in the tuple. Empty tuples, or any empty sequences for that matter, have a length 
of 0. The following lines use the 1 en () function with the tuple: 

# get the length of a tuple 

printCYou have", len(inventory), "items in your possession.") 
input("\nPress the enter key to continue.") 

Since this tuple has four elements (the four strings: "sword", "armor", "shi el d", and "healing 
poti on"), the message You have 4 items in your possessi on. is displayed. 
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Notice that in the tupLe i nventory, the string "heal i ng potion" is counted as a 
singLe eLement, even though it’s two words. 


Using the in Operator with TupLes 

Just like with strings, you can use the i n operator with tuples to test for element membership. 
And, just like hefore, the i n operator is usually used to create a condition. Thafs how I used 
it here: 

# test for membership with in 

if "healing potion" in inventory: 

printCYou will live to fight another day.") 

The condition "heal i ng potion" in i nventory tests if the entire string "heal i ng potion"isan 
elementin i nventory. Since itis, the message You will live to fight another day.is displayed. 

Indexing Tuples 

Indexing tuples works like indexing strings. You specify a position numher, in brackets, to 
access a particular element. In the following lines, 1 let the user choose the index numher and 
then the computer displays the corresponding element: 

# display one item through an index 

index = int(input("\nEnter the index number for an item in inventory: ")) 
printCAt index", index, "is", inventoryLindex]) 

Figure 4.13 shows this tuple with index numbers. 


Q Figure4.I3 ^ 

Each string Is a 
singLe element in 
the tupLe. 


0 

1 

2 

3 

"sword” 

"armor" 

"shield" 

"healing potion" 

-4 

-3 

■2 

-1 


Slicing Tuples 

Slicing works just like you saw with strings. You give a beginning and ending position. The 
resuit is a tuple containing every element between those two positions. 

Just as in the Pizza Slicer program from earlier in this chapter, 1 let the user pick the beginning 
and ending position numbers. Then, like hefore, the program displays the slice: 
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# di splay a sli ce 

start = int(input("\nEnter the index number to begin a slice: ")) 
finish = int(input("Enter the index number to end the slice: ")) 
print("inventoryL", start, finish, "] is", end=" ") 
print(inventory[start:finish]) 

input("\nPress the enter key to continue.") 

Using this tuple as an example, Figure 4.14 provides a visual way to understand tuple slicing. 


0 12 3 4 



' ^ 


▼ 

"sword" 

"armor" 

"shield" 

"healing potion" 






■4 -3 -2 -1 


Figure 4.14 ^ 

SLIcIng positions 
for tupLes are 
defined between 
eLements, just as 
they are for 
strings. 


Understanding Tuple Immutability 

Like strings, tuples are immutable. That means you can’t change a tuple. Here’s an Interactive 
session to prove my point: 

>>> inventory = ("sword", "armor", "shield", "healing potion") 

>>> print(inventory) 

Csword', 'armor', 'shield', 'healing potion') 

>>> inventoryLO] = "battleax" 

Traceback (most recent call last): 

Eile "kpyshel 1#3>'', line 1, in ? 
inventoryLO] = "battleax" 

TypeError: object doesn't support item assignment 

Although you can’t change tuples, like strings, you can create new tuples from existing ones. 

Concatenating Tuples 

You can concatenate tuples the same way you concatenate strings. You simply join them 
together with +, the concatenation operator: 

# concatenate two tuples 
chest = ("gold", "gems") 
printCYou find a chest. It contains:") 
print(chest) 
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printCYou add the contents of the chest to your inventory.") 

inventory += chest 

printCYour inventory is now:") 

print(inventory) 

input( "\n\nPress the enter key to exit.") 

The first thing I did was create a new tuple, chest, with the two string elements "gol d" and 
" gems ". Next, I printed ches t to show its elements. After that, I used an augmented assignment 
operator to concatenate i nventory with chest and assign the resuit hack to i nventory. 1 did 
not modify the original tuple assigned to inventory (since thafs impossihle, hecause tuples 
are immutable). Instead, the augmented assignment operator created a hrand-new tuple with 
the elements from i nventory and chest and assigned that to inventory. 

Back to THE Word Jumble Game 

The Word Jumble game combines several new ideas you learned about in this chapter. You 
can easily modify the program to contain your own list of words to guess. The code for the 
program is on the companion website (www.courseptr.com/downloads) in the Chapter 4 
folder; the file name is wordjumble.py. 

Setting Up the Program 

Affer my initial comments, 1 import the random module: 

# Word Jumble 

# 

# The computer picks a random word and then "jumbles" it 

# The player has to guess the original word 

import random 

Next, i used a tuple to create a sequence of words. Notice that the variable name WORD is in all 
caps, implying that 111 treat it as a constant. 

# create a sequence of words to choose from 

WORDS = ("python", "jumble", "easy", "difficuit", "answer", "xylophone") 

Next, 1 use a new function, random. choi ceO, to grab a random word from WORDS: 

# pick one word randomly from the sequence 
word = random.choice(WORDS) 
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This function is new to you, but it’s pretty simple. The computer looks at whatever sequence 
you give and picks a random element. 

Once the computer has chosen a random word, it assigns it to word. This is the word the player 
will have to guess. Lastly, I assign word to correct, whichlTl use later to see ifthe player makes 
a correct guess: 

# create a vari abi e to use later to see if the guess is correct 
correct = word 

Planning the Jumble Creation Section 

The next section of code uses the new concepts in the chapter and is the most interesting part 
of the program. lt’s the section that actually creates the jumbled word from the original, 
randomly chosen word. 

But, before 1 wrote any code, 1 planned out this part of the program in pseudocode (yes, 1 
actually use all that stuff 1 write about). Here’s my first pass at the algorithm to create a 
jumbled word from the chosen word: 

create an empty jumble word 

while the chosen word has letters in it 

extract a random letter from the chosen word 
add the random letter to the jumble word 

Conceptually, this is pretty good, but 1 have to watch my semantics. Because strings are 
immutable, 1 can’t actually “extract a random letter” from the string the user entered. But, 1 
can create a new string that doesn’t contain the randomly chosen letter. And while 1 can’t 
“add the random letter” to the jumble word string either, 1 can create a new string by con- 
catenating the current jumble word with the “extracted” letter. 

Creating an Empty Jumble String 

The very first part of the algorithm is easy: 

# create a jumbled version of the word 
jumble 

The program creates the empty string and assigns it to jumbl e, which will refer to the final, 
jumbled word. 
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Setting Up the Loop 

The jumble creation process is controlled by a whi 1 e loop. The loop condition is pretty simple, 
as you can see: 

while word: 

1 set the loop up this way so that it will continue until word is equal to the empty string. This 
is perfect, because each time the loop executes, the computer creates a new version of word 
with one letter “extracted” and assigns itbackto word.Eventually, word willbecome the empty 
string and the jumbling will be done. 

Generating a Random Position in word 

The first line in the loop body generates a random position in word, based on its length: 
position = random.randrangeden(word)) 

So, the letter wordLposi ti on] is the letter that is going tobe “extracted” from word and “added 
to” jumbl e. 

Creating a New Version of jumble 

The next line in the loop creates a new version of the string j umbl e. It becomes equal to its 
old self, plus the letter wordLposition]. 

jumble += wordLposition] 

Creating a New Version of word 

The next line in the loop, 

word = word[:position] + word[(position + 1):] 

creates a new version of word minus the one letter at position position. Using slicing, the 
computer creates two new strings from word. The first slice, wordL:posi tion], is every letter 
up to, but not including, wordLposi ti on]. The next slice, wordL (posi tion + 1 ): ], is every letter 
after wordLposition]. These two strings are j oined together and assigned to wo r d , which is now 
equal to its old self, minus the one letter wordLposi ti on]. 

WeLcoming the PLayer 

After the j umbled word has been created, the next section of the program welcomes the player 
to the game and displays the jumbled word to be rearranged; 
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# start the game 
print( 

II II II 

Welcome to Word Jumble! 

Unscramble the letters to make a word. 

(Press the enter key at the prompt to quit.) 

II II II 

) 

printCThe jumble is:", jumble) 

Getting the PLayer's Guess 

Next, the computer gets the player’s guess. The computer keeps asking the player for a guess 
as long as the player doesn’t enter the correct word or press the Enter key at the prompt: 

guess = input( "\nYour guess: ") 
while guess != correct and guess != 
print("Sorry, thafs not it.") 
guess = inputCYour guess: ") 

CongratuLating the Player 

At this point in the program, the player has either correctly guessed the word or quit the 
game. If the player has guessed the word, then the computer offers its hearty congratulations: 

if guess == correct: 

printCThafs it! You guessed it!\n") 

Ending the Game 

Finally, the program thanks the player for playing the game and ends: 
print("Thanks for playing.") 

input("\n\nPress the enter key to exit.") 

SUMMARY 

In this chapter, you learned ahout the concept of sequences. You sawhow to create a sequence 
of numbers with the range( ) function. You saw how strings are really just sequences of char- 
acters. You learned ahout tuples, which let you organize a sequence of any type. You saw how 
to go through the elements of a sequence with a for loop. You learned how to get the length 
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of a sequence and how to check if an element is a member of a sequence. You saw how to copy 
pieces of a sequence through indexing and slicing. You learned about immutability and some 
of the limitations it places on you. But you also saw how to create new sequences from existing 
ones through concatenation, in spite of this immutahility. Finally, you put everything 
together to create a challenging word jumhle game. 


* ' 

Challenges 

1. Writea program thatcountsforthe user. Letthe userenterthe 
starting number, the ending number, and the amount by which 
to count. 

2. Create a program that gets a message from the user and then 
prints it out backwards. 

3. Improve “Word Jumble" so that each word is paired with a hint. 

The player should be able to see the hint if he or she is stuck. 

Add a scoring system that rewards players who solve a jumble 
without asking for the hint. 

4. Create a game where the computer picks a random word and 
the player has to guess that word. The computer telis the 
player how many letters are in the word. Then the player gets 
five chances to ask if a letter is in the word. The computer can 
only respond with “yes" or "no". Then, the player must guess 
the word. 



(^C HAP TE 


Lists and Dictionaries: 
The Hangman Game 


T uples are a great way to work with sequences of any type, but their 
immutability can be limiting. Fortunately, another kind of sequence, the 
list, does everything that the tuple can plus more. Thafs because lists are 
mutable. Elements can be added or removed from a list. You can even sort a list. 
You’11 also be introduced to another t 5 q)e, dictionaries. Whereas lists work with 
sequences of information, dictionaries work with pairs of data. Dictionaries, like 
their real-life counterparts, let you look up one value with another. Specifically in 
this chapter, you’11 learn to do the following: 

• Create, index, and slice a list 
• Add and delete elements from a list 
• Use list methods to append and sort a list 

• Use nested sequences to represent even more complex information 
• Use dictionaries to work with pairs of data 
• Add and delete dictionary items 

Introducing THE Hangman Game 

The project for this chapter is the game of hangman. The computer picks a secret 
Word and the player has to try to guess it, one letter at a time. Each time the player 
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makes an incorrect guess, the computer shows a new image of a figure being hanged. If the 
player doesn’t guess the word in time, the stick figure is a goner. Figures 5.1 through 5.3 show 
off the game in ali its glory. 

Not only is this game fun, hut by the end of the chapter, you’ll know how to create your own 
version. You can have a personalized group of secret words, and even update my marginally 
adequate artwork. 


Q Figure 5.1 

The "Hangman" 
game in action. 
Hmm ... I wonder 
what the word 
couLd be. 
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^ Figure5.3 ) 


This game ended 
badLy, especiaLLy 
for the littLe guy 
made of text. 


UsiNG Lists 


Lists are sequences, just like tuples—but lists are mutable. They can be modified. So, lists can 
do everything tuples can, plus more. Lists work just like tuples, so everything you learned 
about tuples is applicable to lists, which makes learning to use them a snap. 

Introducing the Hero's Inventory 3.0 Program 

This program is based on the Hero’s Inventory 2.0 program, introduced in Chapter 4, in the 
“Creating Tuples” section. But instead of using tuples to store the hero’s inventory, this pro¬ 
gram uses lists. The first part of Hero’s Inventory 3.0 creates the same results as version 2.0. 
In fact, the code is almost exactly the same. The only difference is that it uses lists instead of 
tuples. Figure 5.4 shows off the results of the first part of the program. The second part of the 
program takes advantage of the mutability of lists and does some brand-new things with 
sequences. Figure 5.5 shows that part in action. 
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Q FIGURE5.4 

The heros 
inventory is now 
represented by a 
List. The resuLts 
Look almost 
exactly the same 
as when the 
inventory was 
represented by a 
tupLe in Heros 
Inventory 2.0. 


Figures-S 

Since the hero's 
inventory is 
represented by a 
List, items can be 
added, modified, 
and deLeted. 




Creating a List 

The first lines of the program create a new list, assign it to inventory, and print each 
element. This works almost exactly like it did in Hero’s Inventory 2.0. The only difference is 
that 1 surrounded the elements with square hrackets instead of parentheses, to create a 
list instead of a tuple. You can fin d the code for the program on the companion web- 
site (www.courseptr.com/downloads) in the Chapter 5 folder; the file name is hero's_ 
inventoryS.py. 

# Hero's Inventory 3.0 

# Demonstrates lists 
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# create a list with some items and display with a for loop 
inventory = ["sword", "armor", "shield", "healing potion"] 
printCYour items:") 

for item in inventory: 
print(item) 

input("\nPress the enter key to continue.") 

Using the len() Function with Lists 

The following code is exactly the same as the corresponding code in Hero’s Inventory 2.0. The 
1 en ( ) function works the same with lists as it does with tuples. 

# get the length of a list 

printCYou have", len(inventory), "items in your possession.") 
input("\nPress the enter key to continue.") 

Using the in Operator with Lists 

Again, the code for this section is exactly the same as in the previous version. The i n operator 
works the same with lists as it does with tuples. 

# test for membership with in 

if "healing potion" in inventory: 

printCYou will live to fight another day.") 

Indexing Lists 

Once again, the code is exactly the same as it was with tuples. Indexing a list is the same as 
indexing a tuple—just supply the position number of the element you’re after in brackets. 

# display one item through an index 

index = int(input("\nEnter the index number for an item in inventory: ")) 
printCAt index", index, "is", inventoryLindex]) 

Slicing Lists 

Would you believe that slicing a list is exactly the same as slicing a tuple? Again, you just 
supply the two end points, separated by a colon, in brackets: 

# di splay a sli ce 

start = int(input("\nEnter the index number to begin a slice: ")) 
finish = int(input("Enter the index number to end the slice: ")) 
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print("inventoryC", start, finish, "] is", end=" ") 
print(inventory[start:finish]) 

input( "\nPress the enter key to continue.") 

Concatenating Lists 

Concatenating lists works the same way concatenating tuples does. The only real difference 
here is that I created a list (rather than a tuple) and assigned it to chest. This is a small but 
important difference, because you can only concatenate sequences of the same type. 

# concatenate two 1 ists 
chest = ["gold", "gems"] 

printCYou find a chest which contains:") 
print(chest) 

printCYou add the contents of the chest to your inventory.") 

inventory += chest 

print("Your inventory is now:") 

print(inventory) 

input( "\nPress the enter key to continue.") 

Understanding List Mutability 

At this point, you may be getting a bit tired of reading the phrase “works exactly the same as 
it did with tuples.” So far, with the exception of using brackets instead of parentheses, lists 
seem no different than tuples. But there is one huge difference between them. Lists are muta- 
ble. They can change. As a resuit, there are many things you can do with lists that you can’t 
do with tuples. 

Assigning a New List Element by Index 

Because lists are mutable, you can assign an existing element a new value: 

# assign by index 

printCYou trade your sword for a crossbow.") 

inventoryLO] = "crossbow" 

print("Your inventory is now:") 

print(inventory) 


input( "\nPress the enter key to continue.") 
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The following line from the preceding code assigns the string "crossbow" to the element in 
i nventory at position 0: 

inventoryLO] = "crossbow" 

The new string replaces the previous value (which was " swo rd "). You can see the results when 
the print function displays the newversion of i nventory. 



You can assign an existing List eLement a new vaLue with indexing, but you can't 
create a new element in this way. An attempt to assign a value to a nonexistent 
element wiLL resuLt in an error. 


Assigning a New List Slice 

in addition to assigning a new value to a single element, you can assign a new value to a slice. 
1 assigned the list [ "orb of future tel 1 i ng"] to the slice inventory[4:6]: 

# assign by sii ce 

printCYou use your gold and gems to buy an orb of future telling.") 
inventory[4:6] = ["orb of future telling"] 
printCYour inventory is now:") 
print(inventory) 

input(''\nPress the enter key to continue.") 

This assignment statement replaces the two items inventory[4] and i nventory [5] with the 
string "orb of future tel 1 i ng". Becausel assigned a list with one element to a slice with two 
elements, the length of the list shrunk by one. 

Deleting a List Element 

You can delete an element from a list with dei— simply designate the element after dei: 

# delete an element 

printCIn a great battle, your shield is destroyed.") 

dei inventory[2] 

printCYour inventory is now:") 

print(inventory) 


input("\nPress the enter key to continue.") 
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After this code executes, the element that was at position number 2, the string "shield", is 
removed from i nventory. Deleting an element doesn’t create a gap in a sequence. The length 
of the list shrinks by one, and ali of the elements after the deleted one “slide down” one 
position. So, in this case, there is stili an element in position 2; it’s just the element that was 
at position 3. 

Deleting a List SLice 

You can also delete a slice from a list: 

# delete a slice 

printCYour crossbow and armor are stolen by thieves.") 

dei inventory[:2] 

printCYour i nventory is now:") 

print(inventory) 

input( "\n\nPress the enter key to exit.") 

The following line removes the slice i nventory [: 2], which is ["crossbow", "armor"], from 
inventory: 

dei inventory[:2] 

Just as with deleting an element, the length of the list shrinks and the remaining elements 
form a new, continuous list, starting from position 0. 

UsiNG List Methods 

Lists have methods that allow you to manipulate them. Through list methods, you can add 
an element, remove an element based on its value, sort a list, and even reverse the order of 
a list. 

Introducing the High Scores Program 

The High Scores program uses list methods to create and maintain a list of the user’s best 
scores for a computer game. The program uses a simple, menu-driven interface. The user has 
a fewchoices. He or she can add a new score, delete a score, sort the scores, or quit the program. 
Figure 5.6 shows the program in action. 
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-Bl 


The User chooses 
from a menu to 
maintain the high 
scores List. Behlnd 
the scenes, List 
methods do the 
buLk of the work. 


J C:\Python31\python.exe 


High Scores 


— Exit 

— Show Scores 

— Add a Score 

— Remove a Score 

— Sort Scores 


[Uliat score did you get?: 1000 
High Scores 

0 - Exit 

1 - Show Scores 

2 - Add a Score 

3 - Remove a Score 

4 - Sort Scores 


High Scores 
1000 


High Scores 
0 — Exit 


Show Scores 
Add a Score 

- Remove a Score 

- Sort Scores 


k^boice: . 


Setting Up the Program 

The Setup code for the program is pretty simple. After the initial comments, I create two 
variables. scores is a list that will contain the scores. I set it to an empty list to start out. 
choice represents the user’s choice from the menu. I initialized it to None. You can find the 
code for the program on the companion wehsite (www.courseptr.com/downloads) in the 
Chapter 5 folder; the file name is high_scores.py. 

# High Scores 

# Demonstrates list methods 
scores = [] 

choice = None 

Displaying the Menu 

The whi 1 e loop is the core of the program. It continues until the user enters 0. The rest of this 
code prints the menu and gets the user’s choice: 

while choice != "0": 


print( 
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High Scores 

0 - Exit 

1 - Show Scores 

2 - Add a Score 

3 - Delete a Score 

4 - Sort Scores 

II II II 

) 

choice = input("Choice: ") 
print() 

Exitingthe Program 

I first check if the user wants to quit. If the user enters 0, the computer says “Good-bye.”: 

# exit 

if choice == "0": 

print("Good-bye.") 

If the user enters 0, then the whi 1 e loop’s condition will be false the next time it’s tested. The 
loop will end and so will the program. 

Displaying the Scores 

If the user enters 1, then this el i f block executes and the computer displays the scores: 

# list high-score table 
elif choice == "1": 

printCHigh Scores") 
for score in scores: 
print(score) 

Adding a Score 

If the user enters 2, the computer asks the user for a new score and assigns it to score. The 
last line uses the appendi) list method to add score to the end of scores. The list becomes one 
element longer. 

# add a score 

elif choice == "2": 

score = int(input("What score did you get?: ")) 
scores.append(score) 
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Removing a Score 

When the user enters 3, the computer gets a score from the user to remove. If the score is in 
the list, the computer removes the first occurrence of it. If the score isn’t in the list, the user 
is informed. 

# remove a score 
elif choice == "3": 

score = int(input("Remove which score?: ")) 
if score in scores: 

scores.remove(score) 
el se: 

print(score, "isn't in the high scores list.") 

The code first checks to see ifthe score is in the list. Ifit is, the list method remove () is invoked. 
The method goes through the list, starting at position 0, and searches for the value passed to 
it—in this case, score. When the method finds the first occurrence of the value, that element 
is deleted from the list. If the value is in the list more than once, only the first occurrence is 
removed. So, only the first occurrence of score is removed. Ifthe method successfully removes 
an element from the list, the list hecomes one element shorter. 

Also, notice how remove () is different from dei . The remove () method doesnT delete an ele¬ 
ment based on a position, but rather on a value. 

Watch outwhenyou use the remove() method. Ifyoutry to remove a vaLuethat 
isn't in a List, youTL generate an error. Here's a safe way to do just that: 

MUM if score in scores: 

scores.remove(score) 


Sorting the Scores 

The scores in the list are in the exact order the user entered them. To sort the scores, all the 
user has to do is enter 4: 

# sort scores 
elif choice == "4": 

scores.sort(reverse=True) 


The sort( ) method sorts the elements in the list. This is great, except that by default sort() 
orders the elements in ascending—smallest values first. But what I want is the highest scores 
first. Luckily, you can teli the sort( ) method to sort values in descending order—largest values 
first. You can do this by passing True to the method’s reverse parameter. Thafs just what I 
did here and, as a resuit, the scores are sorted with the highest values first. 
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If you want to sort a List in ascendingorder (smaLLest vaLues first), you can simpLy 
caLL the method without passing vaLues to any parameters. So, if I wanted to sort 
a List caLLed numbers in ascending order, I couLd just use the foLLowing Line: 

numbers.sortO 

Dealing with an Invalid Choice 

If the User enters a number that isn’t a valid choice, the el se clause catches it. The program 
lets the User know that the choice isn’t understood. 

# some unknown choice 
el se: 

printCSorry, but", choice, "isn't a valid choice.") 

Waiting for the User 

After the user enters 0 to exit, the loop ends. As always, the program waits for the user: 
input( "\n\nPress the enter key to exit.") 

YouVe seen a bunch of usefui list methods in action. To get a summary of these methods (plus 
a few more), take a look at Table 5.1. 
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Understanding When to Use Tuples Instead of Lists 

At this point, you maybe thinking, “Why use tuples at all?” It’s true that lists can do everything 
tuples can, plus more. But don’t be so quick to dismiss tuples. There is a place for them in 
your P 5 d;hon programming world. There are a few occasions where tuples make more sense 
than lists. 

• Tuples are faster than lists. Because the computer knows they won’t change, tuples can 
he stored in a way that makes using them faster than using lists. For simple programs, 
this speed difference won’t matter, hut in more complex applications, with very large 
sequences of Information, it could. 

• Tuples’ immutahility makes them perfect for creating constants since they can’t change. 
Using tuples can add a level of safety and clarity to your code. 

• Sometimes tuples are required. In some cases, Python requires immutable values. Okay, 
you haven’t actually seen any of those cases yet, but there is a common situation you’ll 
see when you learn ahout dictionaries, later in this chapter in the “Using Dictionaries” 
section. Dictionaries require immutable types, so tuples will be essential when creating 
some kinds of dictionaries. 

But, because lists are so flexible, you’re probably best off using them rather than tuples the 
majority of the time. 

Using Nested Sequences 

Before, 1 said that lists or tuples can be sequences of anything. If thafs true, then lists can 
contain other lists or tuples, and tuples can contain other tuples or lists. Well, they can, and 
when they do, they’re called nested sequences. Nested sequences are sequences inside other 
sequences. Nested sequences are a great way to organize more complex collections of 
Information. 

Although the term sounds like another cryptic piece of computer jargon, 1 het you create and 
use nested sequences all the time. Let me give you an example. Say you’re making a holiday 
shopping list. You start by making a list of names. Under each name, you list a few possible 
gifts. Well, you’ve just created a nested sequence: you have a list of names and each name 
represents a list of gifts. Thafs all there is to it. 

Introducing the High Scores 2.0 Program 

The last program, High Scores, uses only scores. But most high score lists store a name along 
with a score. Thafs what this new version does. It also has a few other improvements. It 
automatically sorts the scores and even limits the list to just the top five. Figure 5.7 shows a 
sample run. 
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Q FIGURE5.7 ^ 

The new and 
improved version 
of High Scores 
Stores a name with 
a score through 
nested sequences. 



Creating Nested Sequences 

You can create a nested list or tuple like always: type each element, followed by a comma. 
The difference with nested sequences is that you include entire lists or tuples as elements. 
Here’s an example: 

»> nested = ["first", ("second", "third"), ["fourth", "fifth", "sixth"]] 

>» print(nested) 

['first', ('second', 'third'), ['fourth', 'fifth', 'sixth']] 

So, although you see six strings here, nested has only three elements. The first element is the 
string "fi rst", the second element is the tuple ( "second", "thi rd" ), and the third element is 
the list [ "fourth", "fifth", "sixth"]. 

While you can create a list or tuple with any number of lists and tuples, useful nested 
sequences often have a consistent pattern. Take a look at the next example: 

»> scores = [("Moe", 1000), ("Larry", 1500), ("Curly", 3000)] 

>» print(scores) 

[('Moe', 1000), ('Larry', 1500), CCurly', 3000)] 

scores is a list with three elements. Each element is a tuple. Each tuple has exactly two ele¬ 
ments, a string and a number. 








ChapterS • Lists and Dictionaries: The Hangman Game 



This sequence, by the way, represents a high score table with names and scores (like a real 
high score table should!). In this particular instance, Moe got a score of 1,000; Larry got 1,500; 
and Curly got a high score of 3,000. 



ALthoughyou can create nested sequences inside nested sequences many times 
over, as in the foLLowing exampLe, this usuaLLy isn't a good idea. 

nested = ("deep", ("deeper", ("deepest", "stili deepest"))) 

Things can get confusing fast. Even experienced programmers rareLy use se¬ 
quences more than a LeveL or two deep. For most programsyoulL write, one LeveL 
of nesting (Like the scores Listyou just saw) is reaLLy aLLyoulL need. 


Accessing Nested Elements 

You access elements of a nested sequence just like any other sequence, through indexing: 

>>> scores = [("Moe", 1000), ("Larry", 1500), ("Curly", 3000)] 

>>> print(scores[0]) 

CMoe', 1000) 

>>> print(scores[l]) 

('Larry', 1500) 

>>> print(scores[2]) 

('Curly', 3000) 

Each element is a tuple, so thafs exactly what you get when you access one. But what ifyou 
want to access one of the elements of one of the tuples? One way is to assign the tuple to a 
variable and index it, as in; 

>>> a_score = scores[2] 

>>> print(a_score) 

('Curly ', 3000) 

>>> print(a_score[0]) 

Curly 

But there’s a direct way to access "Curly" right from scores: 

>>> print(scores[2][0]) 

Curly 

By supplying two indices with scores[2][0], you’re telling the computer to go get the element 
from scores at position 2 (which is ( "Curly", 3000)) and then, from that, to get the element 
at position 0 (which is "Curly"). You can use this kind of multiple indexing with nested 
sequences to get directly to a nested element. 
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Unpacking a Sequence 

If you know how many elements are in a sequence, you can assign each to its own variable in 
a single line of code: 

>» name, score = ("Shemp", 175) 

>>> print(nanie) 

Shemp 

>>> print(score) 

175 

This is called unpacking and works with any sequence type. Just remember to use the same 
number ofvariables as elements in the sequence, because otherwise you’ll generate an error. 

Setting Up the Program 

Just as in the original High Scores program, 1 set up the variahles and whi 1 e loop. As before, 
if the User enters 0, the computer prints "Good-bye. ".You can find the code for the program 
on the companion website (www.courseptr.com/downloads) in the Chapter 5 folder; the file 
name is high_scores2.py. 

# High Scores 2.0 

# Demonstrates nested sequences 

scores = [] 

choice = None 
while choice != "0": 

print( 

II II II 

High Scores 2.0 

0 - Quit 

1 - List Scores 

2 - Add a Score 

II II II 

) 

choice = input("Choice: ") 
print() 
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# exit 

if choice == "0": 

print("Good-bye.") 

Displaying the Scores by Accessing Nested Tuples 

If the User enters 1, the computer goes through each element in scores and unpacks the score 
and name into the variahles score and name. Then the computer prints them out. 

# display high-score table 
elif choice == "1": 

printCHigh Scores\n") 
print("NAME\tSCORE'') 
for entry in scores: 
score, name = entry 
print(name, "\t", score) 

Adding a Score by Appending a Nested TupLe 

If the User enters 2, the computer lets the user enter a new score and name. With these two 
values, the computer creates a tuple, ent ry. I chose to store the score first in this tuple hecause 
I wanted the entries to he sorted hy score, then name. Next, the computer appends this new 
high score entry to the list. The computer sorts the list and reverses it so that the highest 
scores are first. The final statement slices and assigns the list so that only the top five scores 
are kept. 

# add a score 

elif choice == "2": 

name = inputCWhat is the player's name?: ") 

score = int(input(''What score did the player get?: ")) 

entry = (score, name) 

scores.append(entry) 

scores.sort(reverse=True) 

scores = scores[:5] # keep only top 5 scores 

Dealing with an Invalid Choice 

If the user enters something other than 0, 1, or 2, the el se clause catches it. The program lets 
the user know that the choice wasnT understood. 

# some unknown choice 
else: 

printCSorry, but", choice, ''isn't a valid choice.") 
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Waiting for the User 

After the user enters 0 to exit, the loop ends and the program waits for the user: 
input( "\n\nPress the enter key to exit.") 

Understanding Shared References 

In Chapter 2, you learned that a variable refers to a value. This means that, technically, a 
variable doesn’t store a copy of a value, but just refers to the place inyour computer’s memory 
where the value is stored. For example, language = "Python" Stores the string "Python" inyour 
computer’s memory somewhere and then creates the variable 1 anguage, which refers to that 
place in memory. Take a look at Figure 5.8 for a visual representation. 


Figures-S ^ 

The variabLe 
Language refers to 
a pLace in memory 
where the string 
value " Python " is 
stored. 


language 




"Python" 


To say the variable language Stores the string "Python", like a piece of Tupperware Stores a 
chicken leg, is not accurate. In some programming languages, this might be a good analogy, 
but not in Python. A better way to think about it is like this: A variable refers to a value the 
same way a person’s name refers to a person. It would be wrong (and silly) to say that a person’s 
name “stores” the person. Using a person’s name, you can get to a person. Using a variable 
name, you can get to a value. 

So what does all this mean? Well, for immutable values that youVe been using, like numbers, 
strings, and tuples, it doesn’t mean much. But it does mean something for mutable values, 
like lists. When several variables refer to the same mutable value, they share the same refer- 
ence. They all refer to the one, single copy of that value. And a change to the value through 
one of the variables results in a change for all the variables, since there is only one, shared 
copy to begin with. 

Here’s an example to show how this works. Suppose that Tm throwing a hip, happening party 
with my friends and dignitaries from around the world. (Hey, this is my book. I can make up 
any example I want.) Different people at the party call me by different names, even though 
Tm only one person. Let’s say that a friend calls me “Mike,” a dignitary calls me “Mr. Dawson,” 
and my Pulitzer Prize winning, supermodel girlfriend, just back from her literacy, fundrais- 
ing world-tour (again, my book, my fictional girlfriend) calls me “Honey.” So, all three people 
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refer to me with different names. This is the same way that three variables could ali refer to 
the same list. Here’s the beginning of an interactive session to show you what I mean: 

>>> mike = ["khakis", "dress shirt", "jacket"] 

>>> nir_dawson = mike 
>>> honey = mike 
>>> print(mike) 

['khakis', 'dress shirt', 'jacket'] 

>>> print(mr_dawson) 

['khakis', 'dress shirt', 'jacket'] 

>>> print(honey) 

['khakis', 'dress shirt', 'jacket'] 

So, ali three variables, mi ke, mr_dawson, and honey, refer to the same, single list, representing 
me (or at least what fm wearing at this party). Figure 5.9 helps drive this idea horne. 






The vanabLes 
mi ke, mr_dawson, 
and honey aUrefer 
to the same List. 


honey - 


This means that a change to the list using any of these three variables will change the list 
they ali refer to. Back at the party, let’s say that my girlfriend gets my attention by calling 
“Honey.” She asks me to change my jacket for a red sweater she knitted (yes, she knits too). I, 
of course, do what she asks. In my interactive session, this could be expressed as follows: 

>>> honey[2] = "red sweater" 

>>> print(honey) 

['khakis', 'dress shirt', 'red sweater'] 

The results are what you wouid expect. The element in position number 2 of the list referred 
to by honey is no longer "jacket", but is now "red sweater". 

Now, at the party, if a friend were to get my attention by calling “Mike” or a dignitary were 
to call me over with “Mr. Dawson,” both wouid see me in my red sweater, even though neither 
had anything to do with me changing my clothes. The same is true in Python. Even though I 
changed the value of the element in position number 2 by using the variable honey, that 
change is reflected by any variable that refers to this list. So, to continue my interactive 


session: 
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>» pn'nt(mike) 

['khakis', 'dress shirt', 'red sweater'] 

>» print(nir_dawson) 

['khakis', 'dress shirt', 'red sweater'] 

The element in position number 2 of the list referred to by mike and mr_dawson is "red 
sweater". It has to be since there’s only one list. 

So, the moral of this story is: be aware of shared references when using mutable values. If you 
change the value through one variable, it will be changed for all. 

However, you can avoid this effect if you make a copy of a list through slicing. For example: 

>» mike = ["khakis", "dress shirt", "jacket"] 

>» honey = mi ke[: ] 

>» honey[2] = "red sweater" 

>» print(honey) 

['khakis', 'dress shirt', 'red sweater'] 

>>> print(mike) 

['khakis', 'dress shirt', 'jacket'] 

Here, honey is assigned a copy of mi ke. honey does not refer to the same list. Instead, it refers 
to a copy. So, a change to honey has no effect on mi ke. It’s like Fve been cloned. Now, my 
girlfriend is dressing my clone in a red sweater, while the original me is stili in a jacket. Okay, 
this party is getting pretty weird with my clone walking around in a red sweater that my 
fictional girlfriend knitted for me, so I think it’s time to end this bizarre yet useful analogy. 

One last thing to remember is that sometimes you’ll want this shared-reference effect, while 
other times you won’t. Now that you understand how it works, you can control it. 

Using Dictionaries 

By now you probably realize that programmers love to organize information. You saw that 
lists and tuples let you organize things into sequences. Well, dictionaries let you organize 
information too, but in a different way. With a dictionary, you don’t store information in a 
sequence; instead, you store it in pairs. It’s a lot like an actual dictionary where each entry is 
a pair: a word and its definition. When you look up a word, you get its definition. Python 
dictionaries work the same way: you look up a key and get its value. 

Introducing the Geek TransLator Program 

The high-tech world has created many things that impact our lives, including a culture of its 
own. As the resuit of technology, newwords and concepts have beenborn. The Geek Translator 
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is here to help you understand the technophile in your life. The program creates a dictionary 
with geek terms and definitions. The program not only lets the user look up a term, but also 
add a term, replace a definition, and delete a term. Figure 5.10 illustrates the program in 
action. 




So "uninstaLLed” 
means fired. I was 
totalLy 404 on 
that. 


Creating Dictionaries 

The first thing 1 did in the program was create a dictionary of terms and definitions. The geek 
terms are on the left, and their definitions are on the right. You can find the code for the 
program on the companion website (www.courseptr.com/downloads) in the Chapter 5 folder; 
the file name is geek_translator.py. 

# Geek Translator 

# Demonstrates using dictionaries 

geek = {"404": "clueless. From the web error message 404, meaning page not found.", 
"Googling": "searching the Internet for background information on a person.", 
"Keyboard Plaque" : "the collection of debris found in computer keyboards.", 
"Link Rot" : "the process by which web page links become obsolete.", 

"Percussive Maintenance" : "the act of striking an electronic device to makeTl 
□Tit work.", 

"Uninstal1ed" : "being fired. Especially popular during the dot-bomb era."} 

This code creates a dictionary named geek. It consists of six pairs, called items. As an example, 
one of the items is "Keyboard Plaque" : "the collection of debris found in computer key¬ 
boards. " Each item is made up of a key and a value. The keys are on the left side of the colons. 
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The values are on the right. So, "Keyboard P1 aque" is a key, and its value is "the collection of 
debris found in computer keyboards The key is literally the “key” to getting the value. That 
means you could use the key "Keyboard Plaque" to get its value "the collection of debris 
found in computer keyboards." 

To create your own dictionary, follow the pattern 1 used. Type a key, followed by a colon, 
followed by the key’s value. Use commas to separate all of the key-value pairs, and surround 
the whole thing with curly brackets. Like tuples and lists, you can either t 5 rpe the whole thing 
on one line or use separate lines after any of the commas. 

Accessing Dictionary Values 

One of the most common things you’11 do with a dictionary is use a key to get its value. There 
are a few different ways you can do this. fll showyou an example of each in this section, using 
the interactive interpreter. 

Using a Key to Retrieve a Value 

The simplest way to retrieve a value from a dictionary is by directly accessing it with a key. 
To get a key’s value, just put the key in brackets, following the name of the dictionary. Here’s 
an interactive session to show you what 1 mean (assume that Fve already defined the diction¬ 
ary geek): 

»> geek["404"] 

'clueless. From the web error message 404, meaning page not found. ' 

»> geek["Link Rot"] 

'the process by which web page links become obsolete. ' 

This looks similar to indexing a sequence, but there’s an important difference. When you 
index a sequence, you use a position number. When you look up a value in a dictionary, you 
use a key. This is the only direct way to retrieve a value from a dictionary. In fact, dictionaries 
don’t have position numbers at all. 

One thing that sometimes trips up beginning programmers is that a value can’t be used to 
get a key in a dictionary. That would be like trying to use a definition to find a word in a real- 
life dictionary. Real-life dictionaries just aren’t set up for that Idnd of thing, and neither are 
Python dictionaries. So remember, it’s give a key and get a value, only. 

If you try to get a value from a dictionary by directly accessing it with a key that 
doesn't exist, you'll generate an error: 

>>> geek["Dancing Baloney"] 

Traceback (most recent call last): 
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File ''<pyshel 1#1>", line 1, in <niodule> 
geek[''Dancing Baloney"] 

KeyError: 'Dancing Baloney' 

Since "Dancing Baloney" isn't a key in the dictionary, this resuLts in an error. 
("Dancing Baloney," by the way, means animatedgraphics and othervisuaLeffects 
that have no substantive vaLue, often used by web designers to impress cLients.) 


Testing for a Key with the in Operator Before Retrieving a VaLue 

Since using a nonexistent key can lead to an error, it’s usually best not to directly access a 
dictionary without taking some precautions. One thing you can do is check to see if a key 
exists before attempting to retrieve its value. You can check for the existence of a key with 
the i n operator: 

>>> if "Dancing Baloney" in geek: 

printCI know what Dancing Baloney is. ") 
else: 

printCI have no idea what Dancing Baloney is. ") 

I have no idea what Dancing Baloney is. 

Because the dictionary doesn’t contain "Dancing Baloney" as a key, the condition "Dancing 
Baloney" i n geek is false. So, the computer says it doesn’t know what it is. 

You use the i n operator with dictionaries much the same way youVe used it with lists and 
tuples. You type the value you’re checking for, followed hy i n , followed hy the dictionary. This 
creates a condition. The condition is true if the key is in the dictionary; otherwise, it’s false. 
This is a handy thing to do before trying to get a value. But remember, i n only checks for keys; 
it can’t check for values used this way. 

Using the get() Method to Retrieve a Value 

There’s another way to retrieve a value from a dictionary. You can use the dictionary method 
get (). The method has a built-in safety net for handling situations where you ask for a value 
of a key that doesnT exist. If the key doesnT exist, the method returns a default value, which 
you can define. Take a look at another attempt: 

>>> print(geek.get("Dancing Baloney", "I have no idea.")) 

I have no idea. 
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By using the get () method here, I was guaranteed to get a value back. If this term was in the 
dictionary as a key, then Fd get its definition. Since it wasn’t, I got hack the default value that 
I defined, the string " I have no idea." 

To use the get( ) method, ali you have to do is supply the key you’re looking for followed hy 
an optional default value. If the key is in the dictionary, you get its value. If the key isn’t in 
the dictionary, you get the default value. But here’s the twist: If you don’t supply a default 
value (it’s your option), then you get hack None. Here’s an example I created without providing 
a default value: 

>» print(geek.get("Dancing Baloney")) 

None 

Setting Up the Program 

Time to get hack to the code for the Geek Translator program. After I created the gee k diction¬ 
ary, I implemented the menu system you’ve seen before, this time with five choices. Like 
before, if the user chooses 0, the computer says good-bye. 

choice = None 
while choice != "0": 

print( 

II II II 

Geek Translator 
0 - Quit 

1 - Look Up a Geek Term 

2 - Add a Geek Term 

3 - Redefine a Geek Term 

4 - Delete a Geek Term 

II II II 

) 

choice = input("Choice: ") 
print() 

# exit 

if choice == "0": 

printC'Good-bye.") 
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Getting a Value 

If the User enters 1, the next section asks for a term to look up. The computer checks to see if 
the term is in the dictionary. If it is, the program accesses the dictionary, using the term as 
the key, gets its definition, and prints it out. If the term is not in the dictionary, the computer 
informs the user. 

# get a definition 
elif choice == "1": 

term = inputCWhat term do you want me to translate?: ") 
if term in geek: 

definition = geekiterm] 
print("\n", term, "means", definition) 
el se: 

print( "\nSorry , I don't know", term) 

Adding a Key-VaLue Pair 

Dictionaries are mutable, so you can modify them. If the user enters 2, the next section adds 
a new term to the dictionary: 

# add a term-definition pair 
elif choice == "2": 

term = inputCWhat term do you want me to add?: ") 
if term not in geek: 

definition = input( "\nWhat 's the definition?: ") 
geekiterm] = definition 
print("\n", term, "has been added.") 
el se: 

print( "\nThat term already exists! Try redefining it.") 

The computer asks the user for the new term to add. If the term is not already in the dictionary, 
the computer gets the definition and adds the pair through the line: 

geekiterm] = definition 

This creates a new item in geek. The term is the key and the definition is its value. This is 
exactiy how you assign a new item to a dictionary. You use the dictionary, followed hy the 
key in square brackets, followed by the assignment operator, followed by the key’s value. 

I wrote the program so that the computer refuses to add a term if it’s already in the dictionary. 
This is a safety measure I created to ensure that the user doesnT accidentally overwrite an 
existing term. If the user really wants to redefine an existing term, he or she shouid choose 
menu option 3. 


( 3 > 
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A dash of pessimism is a good thing, at Least when you’re programming. As you 
saw here, I assumed that the user might try to add a new term without reaLizing 
it’s aLready in the dictionary. If I hadn’t checked for this, a user couLd overwrite a 
term without reaLizing it. When you're writing your own programs, try to think 
of things that couLd go wrong, then try to make sure your program can deaL with 
them. So be a pessimist, just a LittLe bit. 


RepLacing a Key-Value Pair 

If the user enters 3, then the next section replaces an existing key-value pair: 

# redefine an existing term 
elif choice == "3": 

term = inputCWhat term do you want me to redefine?: ") 
if term in geek: 

definition = input("What's the new definition?: ") 
geekLterm] = definition 
print(''\n'', term, "has been redefined.") 
el se: 

print( "\nThat term doesn't exist! Try adding it.") 

To replace a key-value pair, I used the exact same line of code that I used for adding a 
new pair: 

geekLterm] = definition 

Python replaces the current value (the definition) with the new one. 

If you assign a vaLue to a dictionary using a key that aLready exists, Python repLaces 
the current vaLue without compLaint. So you have to watch out, because you 
might overwrite the vaLue of an existing key without reaLizing it. 

Deleting a Key-Value Pair 

If the user enters 4, then this el i f block runs: 

# delete a term-definition pair 
elif choice == "4": 

term = inputCWhat term do you want me to delete?: ") 
if term in geek: 
dei geekLterm] 

print( "\nOkay , I deleted", term) 
el se: 

print("\nl can't do that!", term, "doesn't exist in the dictionary.") 




ChapterS • Lists and Dictionaries: The Hangman Game 


147 


The program asks the user for the geek term to delete. Next, the program checks to see if the 
term is actually in the dictionary with the i n operator. If it is, the item is deleted with 

dei geek[term] 

This deletes the item with the key term from the dictionary geek. You can delete any item in 
a dictionary this way. Just put dei in front of the dictionary followed by the key of the item 
you wish to delete in square brackets. 

If the geek term doesn’t exist in the first place, the el se clause executes and the computer 
lets the user Icnow. 

Trying to delete a dictionary item through a key that doesn't exist wiLL give you 
an error. It's a smart move to be sure the key you're using exists. 



Wrapping Up the Program 

The final el se clause lets the user know that he or she entered an invalid choice: 

# some unknown choice 
else: 

print("\nSorry, but", choice, ''isn't a valid choice.") 

input("\n\nPress the enter key to exit.") 

Understanding Dictionary Requirements 

There are a few things you should keep in mind when creating dictionaries: 

• A dictionary can’t contain multiple items with the same key. Think again about a real 
dictionary. It becomes pretty meaningless if you can keep adding the same word with 
totally new definitions whenever you want. 

• A key has to be immutable. It can be a string, a number, or a tuple, which gives you lots 
of possibilities. A key has to be immutable because, if it werenT, you could sneak into a 
dictionary later and change its keys, possibly ending up with two identical keys. And 
you just learned you can’t have that! 

• Values don’t have to be unique. Also, values can be mutable or immutable. They can be 
anything you want. 

There’s even more you can do with dictionaries. Table 5.2 summarizes some useful methods 

that can help you get more out of this type. 
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Table 5.2 Selected Dictionary Methods 




Dictionary views—returned by keys (),values(), and i tems ()—are, in some ways, 
Like Lists. They can be iterated over with a for Loop. However, they are not Lists. 
They can't, for exampLe, be indexed. In addition, views are dynamic, which means 
that their contents are not independent of their associated dictionaries. So, a 
changeto a dictionary is refLected by views of that dictionary. To Learn moreabout 
views, see the documentation section of the officiat Python website 
(www.python.org). 


Back to THE Hangman Game 

By putting together ali youVe learned so far, you can create the Hangman game presented at 
the beginning of the chapter. This program is much longer than anything youVe seen, hut 
don’t he intimidated hy its size. The code isn’t much more complex than that of the other 
projects youVe worked through. The biggest part of the program is just my modest ASCII art, 
the eight versions of the stick figured being hanged. The real meat of the program is not much 
more than a screenful of code. 

Setting Up the Program 

First things first. As always, 1 started with opening comments, explaining the program. Next, 
1 imported the randotn module. 1 need the module to pick a random word from a sequence. 
You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 5 folder; the file name is hangman.py. 
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# Hangman Game 

# 

# The classic game of Hangman. The computer picks a random word 

# and the player wrong to guess it, one letter at a time. If the player 

# can't guess the word in time, the little stick figure gets hanged. 

# imports 
import random 

Creating Constants 

Though there are several screenfuls of code in this next section, I only create three constants 
in ali that programming. First, I created the biggest tuple you’ve seen. It’s really just a 
sequence of eight elements, but each element is a triple-quoted string that spans 12 lines. 

Each string is a representation of the gallows where the stick figure is being hanged. Each 
subsequent string shows a more complete figure. Each time the player guesses incorrectly, 
the next string is displayed. By the eighth entry, the image is complete and the figure is a 
goner. If this final string is displayed, the player has lost and the game is over. 1 assigned this 
tuple to HANGMAN, a variable name in all caps, because EU be using it as a constant. 

# constants 
HANGMAN = ( 

II II II 


II II II 


0 
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Next, I created a constant to represent the maximum number of wrong guesses a player can 
make before the game is over: 

MAX_WR0NG = len(HANGMAN) - 1 

The maximum number of incorrect guesses is one less than the length of HANGMAN. This is 
because the first image of the empty gallows is displayed even before the player makes a first 
guess. So although there are eight images in HANGMAN, the player only gets seven wrong guesses 
before the game is over. 

Finally, I created a tuple containing all of the possible words that the computer can pick from 
for the player to guess. Feel free to modify the program and make up your ovm list. 

WORDS = ("OVERUSED", "CLAM", "GUAM", "TAEEETA", "PYTHON") 

Initializing the Variables 

Next, I initialized the variables. I used the random. choi ce( ) function to pick a random word 
from the list of possible words. I assigned this secret word to the variable word. 

# initialize variables 

word = random.choice(WORDS) # the word to be guessed 

I created another string, so_f a r, to represent what the player has guessed so far in the game. 
The string starts out as just a series of dashes, one for each letter in the word. When the player 
correctly guesses a letter, the dashes in the positions of that letter are replaced with the letter 
itself. 

so_far = * len(word) # one dash for each letter in word to be 

guessed 

1 created wrong and assigned it the number 0. w r o n g keeps track of the number of wrong guesses 
the player makes. 

wrong =0 # number of wrong guesses player has made 

1 created an empty list, used, to contain all the letters the player has guessed: 
used = [] # letters already guessed 

Creating the Main Loop 

1 created a loop that continues until either the player has guessed too many wrong letters or 
the player has guessed all the letters in the word: 
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print("Welcome to Hangman. Good luck!") 

while wrong < MAX_WR0NG and so_far != word: 
print(HANGMAN[wrong]) 

print(''\nYou've used the following letters:\n", used) 
print(''\nSo far, the word is:\n'', so_far) 

Next, I print the current stick figure, based on the number of wrong guesses the player has 
made. The more wrong guesses the player has made, the closer the stick figure is to being 
done in. After that, I display the list of letters that the player has used in this game. And then 
1 Show what the partially guessed word looks like so far. 

Getting the Player's Guess 

1 get the player’s guess and convert it to uppercase so that it can be found in the secret word 
(which is in all caps). After that, 1 make sure that the player hasn’t already used this letter. If 
the player has already guessed this letter, then 1 make the player enter a new character until 
the player enters one he or she hasn’t used yet. Once the player enters a valid guess, 1 convert 
the guess to uppercase and add it to the list of used letters. 

guess = input( "\n\nEnter your guess: ") 
guess = guess.upper() 

while guess in used: 

print("You've already guessed the letter", guess) 
guess = inputCEnter your guess: ") 
guess = guess.upper() 

used.append(guess) 

Checking the Guess 

Next, 1 check to see if the guess is in the secret word. If it is, 1 let the player know. Then 1 go 
about creating a new version of so_far to include this new letter in all the places where the 
letter is in the secret word. 

if guess in word: 

print( "\nYes !", guess, "is in the word!") 

# create a new so_far to include guess 


new 


II II 
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for i in range(len(word)): 
if guess == word[i]: 

new += guess 
else: 

new += so_far[i] 
so_far = new 

If the player’s guess isn’t in the word, then I let the player know and increase the numher of 
wrong guesses hy one. 

el se: 

print( "\nSorry ,", guess, "isn't in the word.") 
wrong += 1 

Ending the Game 

At this point, the game is over. If the numher of wrong guesses has reached the maximum, 
the player has lost. In that case, I print the final image of the stick figure. Otherwise, I con¬ 
gratulate the player. In either case, I let the player know what the secret word was. 

if wrong == MAX_WR0NG: 
print(HANGMAN[wrong]) 
print("\nYou've been hanged!") 
el se: 

print("\nYou guessed it!") 
print("\nThe word was", word) 
input( "\n\nPress the enter key to exit.") 

SUMMARY 

In this chapter, you learned all about lists and dictionaries, two new types. You learned that 
lists are mutable sequences. You saw how to add, delete, sort, and even reverse list elements. 
But even with all that lists offer, you learned that there are some cases where the less flexible 
tuple is actually the better (or required) choice. You also learned about shared references that 
can occur with mutable types and saw how to avoid them when necessary. You saw how to 
create and use nested sequences to work with even more interesting information, like a high 
score list. You learned how to create and modify dictionaries that let you work with pairs of 
data, too. 
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Challenges 

1. Create a program that prints a List of words in random order. 
The program should print all the words and not repeat any. 

2. Write a Character Creator program for a role-playinggame. The 
player should be given a pool of 30 points to spend on four 
attributes: Strength, Health, Wisdom, and Dexterity. The 
player should be able to spend points from the pool on any 
attribute and should also be able to take points from an 
attribute and put them back into the pool. 

3. Write a Who's Your Daddy? program that lets the user enter 
the name of a male and produces the name of his father. (You 
can use celebrities, fictional characters, or even historical 
figures for fun.) Allow the user to add. replace, and delete son- 
father pairs. 

4. lmprovetheWho's Your Daddy program byaddinga choice that 
lets the user enter a name and get back a grandfather. Your 
program should stili only use one dictionary of son-father 
pairs. Make sure to include several generations in your 
dictionary so that a match can be found. 
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C H A P T E R 


D 

Functions: The Tic-Tac- 
Toe Game 


E very program youVe written so far has been one large, continuous series 
of instructioris. Once your programs reach a certain size or level of com- 
plexity, it becomes hard to work with them this way. Fortunately, there 
are ways to break up big programs into smaller, manageable chunks of code. In 
this chapter, you learn one way of doing this by creating your own functions. 
Specifically in this chapter, you’11 learn to do the following: 

• Write your own functions 

• Accept values into your functions through parameters 
• Return information from your functions through return values 
• Work with global variables and constants 
• Create a computer opponent that plays a strategy game 

Introducing THE Tic-Tac-Toe Game 

In this chapter project, you’11 learn how to create a computer opponent using a 
dash of artificial intelligence (AI). In the game, the player and computer square off 
in a high-stakes, human-machine showdown of Tic-Tac-Toe. The computer plays a 
formidable, though not perfect, game, and comes with enough attitude to make 
any match fun. Figures 6.1 through 6.3 illustrate the gameplay. 
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Q Figure6.i ^ 

The computer is 
fuLL of... 
confidence. 




I did not see that 
Corning. Even with 
simpLe 

programming 
techniques, the 
computer makes 
some pretty good 


C: \Pvthon31 \python.exe 


Ubei»e will you move? <0 - 8>:1 
Fine... 


HEID 



I pi^edicted, human, I am triumphant once more. 

Proof that computers are superior to humans in all regards. 


llPress the enter kei; to quit. 


Q Figure6.3 ^ 

I found the 
computer's 
weakness and won 
this time. 
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Creating Functions 

YouVe already seen several built-in functions in action, including 1 en( ) and range( ). Well, if 
these aren’t enough for you, Python lets you create functions ofyour very own. Your functions 
Work just like the ones that come Standard with the language. They go off and perform a task 
and then return control to your program. Creating your own functions offers you many 
advantages. One of the biggest is that it allows you to break up your code into manageable, 
hite-sized chunks. Programs that are one, long series of instructions with no logical hreaks 
are hard to write, understand, and maintain. Programs that are made up of functions can he 
easier to create and work with. Just like the functions youVe already met, your new functions 
should do one job well. 

Introducing the Instructions Program 

From the screen shots of the Tic-Tac-Toe game, you can prohahly teli that the computer oppo¬ 
nent has a little attitude. It comes across quite clearly in the instructions the computer gives 
before the game. YouTl get a look at the code that produces those instructions in this next 
program, Instructions. The code is a little different than you might expect. Thafs hecause 1 
created a function to display the instructions. 1 used that same function here in Instructions. 
Take a look at Figure 6.4 to see a sample run of the program. 


^y[C:\Python31 \python.exe HEID 

Hei»e are the instructions to the Tic-Tac-Toe game: Q 

Welcome to the greatest intellectual challenge of all time: Tic-Tac-Toe. H 
This will be a showdown between your human brain and my Silicon processor. H 

You will make your mooe known by entering a number, 0-8. The number H 

will correspond to the board position as illustrated: 


0 

1 

! 2 

3 

4 

! 5 

6 

7 

! 8 


Prepare yourself, human. The ultimate battle is about to begin. 

Here they are again: 

Welcome to the greatest intellectual challenge of all time: Tic-Tac-Toe. 
This will be a showdown between your human brain and my Silicon processor. 

You will make your mooe known by entering a number, 0-8. The number 
will correspond to the board position as illustrated: 


0 

1 

I 2 

3 

4 

! 5 

6 

7 

I 8 


Prepare yourself, human. The ultimate battle is about to begin. 
Vou probably understand the game by now. 

Press the enter key to exit. 


Q Figure 6-4 ^ 

The instructions 
are dispLayed each 
time with just a 
singLe Line of code: 
a caLL to a function 
I created. 
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You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 6 folder; the file name is instructions.py. 

# Instructions 

# Demonstrates programmer-created functions 

def instructions(): 

.Display game instructions.. 

print( 

II II II 

Welcome to the greatest intellectual challenge of all time: Tic-Tac-Toe. 

This will be a showdown between your human brain and my Silicon processor. 

You will make your move known by entering a number, 0 - 8. The number 
will correspond to the board position as illustrated: 

0 I 1 I 2 


3 I 4 I 5 


6 I 7 I 8 

Prepare yourself, human. The ultimate battle is about to begin. \n 

II II II 

) 

# main 

printCHere are the instructions to the Tic-Tac-Toe game:") 
instructions!) 

printCHere they are again:") 
instructions!) 

print!"You probably understand the game by now.") 


input! "\n\nPress the enter key to exit.") 
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Defininga Function 

I began the definitiori of my new function with a single line: 
def instructions(): 

This line telis the computer that the hlock of code that follows is to he used together as the 
function instructions( ). Fm hasically naming this hlock of statements. This means that 
whenever 1 call the function i nstructi ons () in this program, the hlock of code runs. 

This line and its hlock are a function definition. They detine what the function does, hut don’t 
run the function. When the computer sees the function definition, it makes a note that this 
function exists so it can use it later. It won’t actually run the function until it sees a function 
call for it, later in the program. 

To define a function ofyour own, followmy example. Startwith def, followedhyyour function 
name, followed hy a pair of parentheses, followed hy a colon, and then your indented hlock 
of statements. To name a function, follow the hasic rules for naming variahles. Also, try to 
use a name that conveys what the function produces or does. 

Documentinga Function 

Functions have a special mechanism that allows you to document them with whafs called a 
docstring (or documentation string). 1 created the following docstring for i nstructi ons (): 

.Display game instructions.. 

A docstring is typically a triple-quoted string and, if you use one, must be the first line in your 
function. For simple functions, you can do what 1 did here: write a single sentence that 
describes what the function does. Functions workjust fine without docstrings, hut using them 
is a good idea. It gets you in the habit of commenting your code and makes you describe the 
function’s one, well-defined joh. Also, a function’s docstring can pop up as interactive docu¬ 
mentation while you t 3 rpe your call to it in IDLE. 

CaLUnga Programmer-Created Function 

Calling a programmer-created function works just like calling a built-in function. Use the 
name of the function followed by a set of parentheses. 1 called my new function several times, 
each time with the line: 

instructionsO 

This telis the computer to go off and execute the function 1 defined earlier. So each time 1 call 
it, the computer prints the instructions to the game. 
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Understanding Abstraction 

By writing and calling functions, you practice whafs known as abstraction. Abstraction lets 
you think about the big picture without worrying about the details. So, in this program, I can 
just use the function instructions( ) without worr 3 dng ahout the details of displaying the 
text. All I have to do is call the function with one line of code, and it gets the job done. 

You might be surprised where you find abstraction, but people use it all the time. For example, 
consider two employees at a fast food place. If one telis the other that he just filled a #3, and 
“sized it,” the other employee knows that the first employee took a customer’s order, went 
to the heat lamps, grahhed a hurger, went over to the deep fryer, filled their biggest cardhoard 
Container with French fries, went to the soda fountain, grahhed their biggest cup, filled it 
with soda, gave it all to the customer, took the customer’s money, and gave the customer 
change. Not only would this version be a boring conversation, but it’s unnecessary. Both 
employees understand what it means to fili a #3 and “size it.” They don’t have to concern 
themselves with all the details because they’re using abstraction. 

UsiNG Parameters and Return Values 

As you’ve seen with huilt-in functions, you can provide a function values and get values hack 
from them. With the 1 en () function, for example, you provide a sequence, and the function 
returns its length. Your own functions can also receive and return values. This allows your 
functions to communicate with the rest ofyour program. 

Introducing the Receive and Return Program 

1 created three functions in the program Receive and Return to show the various comhinations 
of receiving and returning values. One function receives a value. The next function returns 
a value. And the last function both receives and returns a value. Take a look at Figure 6.5 to 
see exactly what happens as a resuit of the program. 


Q Figure 6-5 ^ 

Each function uses 
a parameter, a 
return vaLue, or 
both to 

communicate with 
the main part of 
the program. 



You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 6 folder; the file name is receive_and_return.py. 
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# Receive and Return 

# Demonstrates parameters and return values 

def display(message): 
pri nt(tnessage) 

def gi ve_me_fi veO : 
fi ve = 5 
return fi ve 

def ask_yes_no(question): 

.Ask a yes or no question.. 

response = None 

while response not in ("y", "n"): 

response = input(question).lower() 
return response 

i main 

display("Here's a message for you.\n") 
number = gi ve_nie_fi ve() 

print("Here's what I got from give_me_fiveO:", number) 

answer = ask_yes_no( "\nPlease enter 'y' or 'n': ") 
print("Thanks for entering:", answer) 

input(''\n\nPress the enter key to exit.") 

Receiving Information through Parameters 

The firstfunctionidefined, di spl ay (), receives avalueandprints it. It receives avalue through 
its parameter. Parameters are essentially variable names inside the parentheses of a function 
header: 

def display(message): 

Parameters catch the values sent to the function from a function call through its arguments. 
So here, when di spl ay () is called, message is assigned the value provided through the argu- 
ment"Here's a message for you.\n" 
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In the main part of the program, I call di spl ay( ) with 
display("Here's a tnessage for you.\n") 

As a resuit, message gets the string "Here' s a message for you.\n". Then, the function runs. 
message, like any parameter, exists inside the function as a variahle. So, the line 

print(message) 

prints the string "Here's a message for you.\n". 

If I hadn’t passed message a value, I would have generated an error. The function di spl ay() 
requires exactly one argument value. 

Although di spl ay( ) has only one parameter, functions can have many. To define a function 
with multiple parameters, list them out, separated by commas. 


Returning Information through Return Values 

The next function I wrote, gi ve_me_f i ve (), returns a value. It returns a value through (believe 
it or not) the return statement: 

return fi ve 


When this line runs, the function passes the value of f i ve back to the part of the program 
that called it, and then ends. A function always ends after it hits a return statement. 

It’s up to the part of the program that called a function to catch the values it returns and do 
something with them. Here’s the main part of the program, where I called the function: 

number = give_me_five() 

print("Here's what I got from give_me_five():", number) 

I set up a way to catch the return value of the function by assigning the resuit of the 
function call to number. So, when the function finishes, number gets the return value of 
gi ve_me_fi ve( ), which is equal to 5. The next line prints number to show that it got the return 
value okay. 

You can pass more than one value back from a function. Just list ali the values you want to 
return, separated by commas. 



Make sure to have enough variabLes to catch alL the return values of a function. 
If you don't have the right number when you try to assign them, youTL generate 
an error. 
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Understanding EncapsuLation 

You might not see the need for return values when using your own functions. Why not just 
use the variable fi ve back in the main part of the program? Because you can’t. fi ve doesn’t 
exist outside of its function gi ve_nie_f i ve( ). In fact, no variable you create in a function, 
including its parameters, can be directly accessed outside its function. This is a good thing 
and is called encapsulation. Encapsulation helps keep independent code truly separate by hid- 
ing or encapsulating the details. Thafs why you use parameters and return values: to 
communicate just the information that needs to be exchanged. Plus, you don’t have to keep 
track of variables you create within a function in the rest of your program. As your programs 
get large, this is a great benefit. 

Encapsulation might sound a lot like abstraction. Thafs because they’re closely related. 
Encapsulation is a principal of abstraction. Abstraction saves you from worrying about the 
details. Encapsulation hides details from you. As an example, consider a remote control for 
a TV with volume up and down buttons. When you use a TV remote to change the volume, 
you’re employing abstraction, because you don’t need to Imow what happens inside the TV 
for it to Work. Now suppose the TV remote has 10 volume levels. You can get to them all 
through the remote, but you can’t directly access them. That is, you can’t get a specific volume 
number directly. You can only press the up volume and down volume buttons to eventually 
get to the level you want. The actual volume number is encapsulated and not directly available 
to you. 

Don’t worry if you don't totaLLy get the subtLe difference between abstraction 
and encapsulation right now. They're intertwined concepts, so it can be a LittLe 
tricky. Plus, youTLget to see them in action again when you Learn about Software 
objects and object oriented programming in Chapters 8 and 9. 



Receiving and Returning Values in the Same Function 

The final function I wrote, ask_yes_no( ), receives one value and returns another. It receives 
a question and returns a response from the user, either "y" or "n". The function receives the 
question through its parameter: 

def ask_yes_no(question): 

question gets the value of the argument passed to the function. In this case, ifs the string, 
''\nPlease enter 'y' or 'n': ". The next part of the function uses this string to prompt the 
user for a response: 

response = None 

while response not in ("y". "n"): 

response = input(question).lower() 
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The whi 1 e loop keeps asldng the question until the user enters either y, Y, n, or N. The function 
always converts the user’s entry to lowercase. 

Finally, when the user has entered a valid response, the function sends a string back to the 
part of the program that called it with 

return response 

and the function ends. 

In the main part of the program, the return value is assigned to answer and printed: 

answer = ask_yes_no("\nPlease enter 'y' or 'n': ") 
print("Thanks for entering:", answer) 

Understanding Software Reuse 

Another great thing ahout functions is that they can easily be reused in other programs. For 
example, since asldng the user a yes or no question is such a common thing to do, you could 
grab the a s k_y e s_n o () function and use it in another program without doing any extra coding. 
This type of thing is called Software reuse. So writing good functions not only saves you time 
and energy in your current project, but can also save you effort in future ones! 


\ 

In THE Real World 

lt's always a waste of time to “reinvent the wheel," so Software reuse, using existing 

Software and other project elements in new projects, is a technique that business has 

taken to heart. Software reuse can do the following: 

• Increase company productivity. By reusing code and other elements that already exist, 
companies can get their projects done with less effort. 

• Improve Software quality. If a company already has a tested piece of code, then it can use 
the code with the knowledge that it’s bug-free. 

• Provide consistency across Software products. By using the same user interface, for exam¬ 
ple, companies can create new Software that users feel comfortable with right out of the 
box. 

• Improvesoftwareperformance.Onceacompany has a good wayof doing somethingthrough 
Software, using it again not only saves the company the trouble of reinventing the wheel, 
but also saves it from the possibility of reinventing a less efficient wheel. 



Chapter6 • Functions: The Tic-Tac-Toe Game 



One way to reuse functions youVe written is to copy them into your new program. But there 
is a better way. You can create your own modules and i mport your functions into a new pro¬ 
gram, just like you i mport Standard Python modules and use their functions. You’11 learn how 
to create your own modules and import reusable code you’ve written in Chapter 9, in the 
“Creating Modules” section. 

UsiNG Keyword Arguments and Default Parameter Values 

Passing values through arguments to parameters allows you to give Information to a function. 
But so far, you’ve only seen the most basic way to do that. Python allows greater control and 
flexibility with the way you pass Information, through default parameter values and ke 5 word 
arguments. 

Introducing the Birthday Wishes Program 

The program Birthday Wishes, a sample run ofwhich is pictured in Figure 6.6, sends birthday 
greetings through two very similar functions. The first function uses the type of parameters 
you saw in the last section, called positional parameters. The second version of the function uses 
default parameter values. The best way to appreciate the difference is to see examples of them 
in aedon. 


C:\Python31\python.exe 




Happy 

birthday. 

Jacknon ? I 

hear you're 1 

today. 


Happp 

bii^thday. 

1 t 1 hear 

you're Jackson 

today. 


Happy 

birthday. 

Jackson ? I 

hear you're 1 

today. 


fi. 

fi. 

z 

birthday. 

Jackson ? I 

hear you're 1 

today. 


Happv 

birthday. 

Jackson ? I 

hear you're 1 

today. 


Happv 

birthday. 

Katherine ? 

I hear you're 

1 today. 


Happv 

birthday. 

Jackson t I 

hear you're 12 today. 


Happv 

birthday. 

Katherine t 

I hear you're 

12 today. 


Happv 

birthday. 

Katherine t 

I hear you're 

12 today. 


Press 

the enter 

key to exit. 





Q Figure 6.6 ^ 

Functions can be 
caLLed In different 
ways with the 
fLexIbILIty of 
keyword 
arguments and 
default parameter 
values. 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 6 folder; the file name is hirthday_wishes.py. 

# Birthday Wishes 

# Demonstrates keyword arguments and default parameter values 
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# positional parameters 
def birthdayKname, age): 

printCHappy birthday,", name, " I hear you're", age, "today.\n") 

# parameters with default values 

def birthday2(name = "Jackson", age = 1): 

printCHappy birthday,", name, "!", " I hearyou're", age, "today.\n'') 


bi rthdayK "Jackson", 1) 
birthdayld, "Jackson") 
bi rthdayKname = "Jackson", age = 1) 
birthdayKage = 1, name = "Jackson") 

birthday2() 

birthday2(name = "Katherine") 
birthday2(age = 12) 

birthday2(name = "Katherine", age = 12) 
birthday2("Katherine", 12) 

input( "\n\nPress the enter key to exit.") 

Using Positional Parameters and Positional Arguments 

If you just list out a series of variable names in a fiinction’s header, you create positional 
parameters: 

def bi rthdayKname, age): 

If you call a function with just a series of values, you create positional arguments: 
bi rthdayK "Jackson", 1) 

Using positional parameters and positional arguments means that parameters get their val¬ 
ues based solely on the position of the values sent. The first parameter gets the first value 
sent, the second parameter gets the second value sent, and so on. 

Withthis particular function call, it means that name gets "Jackson" andagegets l.This results 
inthemessage: Happy Birthday, Jackson ! I hear you're 1 today. Ifyouswitch the positions 
of two arguments, the parameters get different values. So with the call 


birthdayKl, "Jackson") 
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natne gets the first value, 1, and age gets the second value, "Jackson". As a resuit, you end up 
withamessageyouprobably didn’tintend: Happy Birthday, 1 ! I hear you're Jackson today. 

YouVe seen tbis way of creating and calling functions already. But tbere are otber ways to 
create parameter and argument lists in your programs. 


Using Positional Parameters and Keyword Arguments 

Positional parameters get values sent to tbem in order, unless you teli tbe function otberwise. 
You can teli tbe function to assign certain values to specific parameters, regardless of order, 
ifyou use ke 5 word arguments. Witb ke 5 word arguments, you use tbe actual parameter names 
from tbe function beader to link a value to a parameter. So, by calling tbe same function 
bi rthdayK ) witb 

birthdayKname = "Jackson", age = 1) 

name gets "Jackson" and age gets 1 and tbe function displays tbe message Happy Birthday, 
Jackson ! I hear you're 1 today. Tbis isn’tterriblyimpressive. You could acbieve tbe same 
results witbout keyword arguments by just sending tbese values in tbis order. But tbe beauty 
of keyword arguments is tbat tbeir order doesnT matter; it’s tbe keywords tbat link values 
to parameters. So tbe call 

birthdayKage = 1, name = "Jackson") 


also produces tbe message Happy Birthday, Jackson ! I hear you're 1 today . even tbougb 
tbe values are listed in opposite order. 

Ke 5 word arguments let you pass values in any order. But tbeir biggest benefit is clarity. Wben 
you see a function call using keyword arguments, you get a mucb better understanding of 
wbat tbe values represent. 



You can combine keyword arguments and positional arguments in a singLe func¬ 
tion call, but tbis can get tricky. Once you use a keyword argument, alL the 
remaining arguments in the call must be keyword arguments, too. To keep things 
simple, try to use all keyword or all positional arguments in your function calls. 


Using Default Parameter Values 

Finally, you bave tbe option to assign default values to your parameters, values tbat get 
assigned to tbe parameters if no value is passed to tbem. Tbafs just wbat 1 did witb tbe 
bi rthday2( ) function. 1 made cbanges in tbe beader only: 

def birthday2(name = "Jackson", age = 1): 
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This means that if no value is supplied to name, it gets " Jackson". And if no value is supplied 
for age, it gets 1. So the call 

birthday2() 

doesn’t generate an error; instead, the default values are assigned to the parameters, and the 
function displays the message Happy Birthday, Jackson ! I hear you're 1 today. 



Once you assign a defauLt value to a parameter in the List, you have to assign 
defauLt vaLues to aLL the parameters Listed after it. So, this function header is 
perfectLy fine: 

def nionkey_around(bananas = 100, barrel_of = "yes", “^3 
cr unde = "nionkey's"): 


But this isn't: 

def monkey_around(bananas = 100, barrel_of, unde): 


The above header wiLL generate an error. 


So far, so good. But you can add a wrinlde here by overriding the default values of any or all 
the parameters. With the call 

birthday2(name = "Katherine") 

the defaultvalue of name is overridden. name gets "Katheri ne", age stili gets its defaultvalue of 
1, and the message Happy Birthday, Katherine ! I hear you're 1 today . is displayed. 

With this function call: 

birthday2(age = 12) 

the default value of age is overridden. age gets the value of 12. name gets its default value of 
"Jackson". And the message Happy Birthday, Jackson ! I hear you're 12 today . is displayed. 

With the call 

birthday2(name = "Katherine", age = 12) 

both default values are overridden. name gets "Katherine" and age gets 12. The message Happy 
Birthday, Katherine ! I hear you're 12 today. is displayed. 

And with the call 


birthday2("Katherine", 12) 
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you get the exact same results as you did with the previous call. Both default values are over- 
ridden. name gets "Katherine" and age gets 12. And the message Happy Birthday, Katherine ! 

I hear you're 12 today . is displayed. 

DefauLt parameter vaLues are great if you have a function where aLmost every 
time it's caLLed, some parameter gets sent the same vaLue. To save programmers 
using your function the troubLe of typing this vaLue every time, you couLd use a 
default parameter vaLue instead. 

Using Global Variables and Constants 

Through the magic of encapsulation, the functions you’ve seen are all totally sealed off and 
independent from each other and the main part of your program. The only way to get infor- 
mation into them is through their parameters, and the only way to get information out of 
them is from their return values. Well, thafs not completely true. There is another way that 
you can share information among parts of your program: through global variables. 

Understanding Scopes 

Scopes represent different areas of your program that are separate from each other. For exam- 
ple, each function you define has its own scope. Thafs why the functions you’ve seen can’t 
directly access each other’s variables. A visual representation really helps to gei this idea, so 
take a look at Figure 6.7. 



def func1(): 
variablel 


def func2(): 
variable2 


^ Figure 6-7 ^ 

This simple 
program has three 
different scopes: 

one for each 
function, plus one 
for the global 
scope. 


variableO 
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Figure 6.7 shows a program with three different scopes. The first is defined by function 
funcK ), the second is defined by function func2( ), and the third is the global scope (which 
all programs automaticallyhave). In this program, you’re in the global scope whenyouhe not 
inside any function. The shaded area in the figure represents the global scope. Any variable 
that you create in the global scope is called a global variable, while any variable you create 
inside a function is called a local variable (it’s local to that function). 

Since variabl el is defined inside funcK ), it’s a local variable that lives only in the scope of 
funcK ). vari abi el can’t be accessed from any other scope. So, no command in func2( ) can 
get at it, and no command in the global space can access or modify it either. 

A good way to remember how this works is to think of scopes as houses and encapsulation as 
tinted Windows, giving each house privacy. As a resuit, you can see anything inside a house 
if you’re in it. But if you’re outside a house, you can’t see whafs inside. This is the way it works 
with functions. When you’re in a function, you have access to all of its variables. But when 
you’re outside a function, like in the global scope, you can’t see any of the variables inside a 
function. 

If two variables have the same name inside two separate functions, they’re totally different 
variables with no connection to each other. For example, if I created a variable called 
variabl e2 inside function funcK ), it would be different and completely separate from the 
variable named v a r i a b 1 e 2 in function f u n c 2 (). Because of encapsulation, it would be like they 
exist in different worlds and have no effect on each other. 

Global variables, however, create a little wrinkle in the idea of encapsulation, as youTl see. 

Introducing the Global Reach Program 

The Global Reach program shows how you can read and even change global variables from 
inside functions. Figure 6.8 displays the program’s results. 


Q Figure 6.8 ^ 

You can read, 
shadow, or even 
change the vaLue 
of a global variable 
from inside a 
function. 


C:\Python31\python.exe 
In tlie global scope, oalue has been set to: 10 

Frotn inside the local scope of read_global<>, oalue is: 10 
Hack in the global scope, oalue is stili: 10 

Fi*om inside the local scope of shadow_global<>, oalue is: -10 
Back in the global scope, oalue is stili: 10 

From inside the local scope of change_global<>, ualue is: -10 
Rack in the global scope, oalue has now changed to: -10 


HEID 


Press the enter key to exit._ 
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You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 6 folder; the file name is glohal_reach.py. 

# Global Reach 

# Demonstrates global variables 
def read_global(): 

print("From inside the local scope of read_global(), value is:", value) 

def shadow_global(): 
value = -10 

print("From inside the local scope of shadow_global(), value is:", value) 

def change_global(): 
global value 
value = -10 

printCFrom inside the local scope of change_gl obal (), value is:", value) 

# main 

# value is a global variable because we're in the global scope here 
value = 10 

printCIn the global scope, value has been set to:", value, "\n") 
read_global() 

printCBack in the global scope, value is stili:", value, "\n") 
shadow_global() 

printCBack in the global scope, value is stili:", value, "\n") 
change_global() 

printCBack in the global scope, value has now changed to:", value) 


inputC\n\nPress the enter key to exit.") 
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Reading a Global Variable from Inside a Function 

Although by now you’re probably quite comfortable with the idea of encapsulation, Fm 
going to throw you a little curve ball: you can read the value of a global variable from within 
any scope in your program. But fear not, this can stili work with the concept of houses and 
tinted Windows. Remember, tinted Windows keep the houses (or functions) private. But 
tinted Windows also let you see out. So, you can always see outside of a function to the global 
scope and see the value of a global variable. Thafs what 1 did when 1 created the function 
read_gl obal (). It prints the global variable val ue without a problem. 

While you can always read the value of a global variable in any function, you can’t change it 
directly (at least not without asking specifically for that kind of access). So, in read_gl oba 1 (), 
doing something like the following would generate a nasty error: 

value += 1 

Back to the houses and tinted glass idea, this means that you can see a global variable from 
within a function through the tinted window, but you can’t touch it because it’s outside. So, 
although you can read the value of a global variable from inside a function, you can’t change 
its value without asldng for special access to it. 


Shadowing a Global Variable from Inside a Function 

If you give a variable inside a function the same name as a global variable, you shadow the 
global variable. That is, you hide it with your new variable. It might look like you can change 
the value of a global variable by doing this, but you only change the local variable youVe 
created. Thafs what 1 did in the function shadow_gl obal (). When 1 assigned -10 to val ue with 

value = -10 


1 didn’t change the global version of value. Instead, 1 created a new, local version of val ue 
inside the function and that got -10. You can see that this is what happened, because when 
the function finishes, the main program prints out the global version of val ue with 

printCBack in the global scope, value is stili:", value, "\n") 

and it’s stili 10. 



It's not a good idea to shadow a global variable inside a function. It can lead to 
confusion. You might thinkyouYe using a global variable whenyouYe really not. 
Be aware of any global variables in your program and make sure not to use the 
name anywhere else in your code. 
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Changing a Global Variable from Inside a Function 

To gain complete access to a global variable, use the ke 5 word gl oba 1 like 1 did in the function 
change_globa1(): 

global value 

At this point, the function has complete access to val ue. So when 1 changed it with 
value = -10 

the global variable value got -10. When the program prints value again back in the main part 
of the code with 

printCBack in the global scope, value has now changed to:", value) 

-10 is printed. The global variable was changed from inside the function. 

Understanding When to Use Global Variables and Constants 

Just because you can, doesn’t mean you should. This is a good programming motto. Some- 
times things are technically possible, but not good ideas. Using global variables is an example 
of this. In general, global variables make programs confusing because it can be hard to keep 
track of their changing values. You should limit your use of them as much as you can. 

Global constants (global variables that you treat as constants), on the other hand, can make 
programs less confusing. For example, say you’re writing a business application that calcu- 
lates someone’s taxes. Like a good programmer, you have written a variety of functions in 
your code, all of which use the somewhat cryptic value . 28 as the tax rate. Instead, you could 
create a global constant called TAX_RATE and set it to .28. Then, in each function, you could 
replace the numher . 28 with TAX_RATE. This produces two henefits. It makes your code clearer 
and it makes changes (like a new tax rate) no sweat. 

Backto THE Tic-Tac-Toe Game 

The Tic-Tac-Toe game presented at the beginning of the chapter is your most ambitious chap- 
ter project yet. You certainly have all the skills you need to create the game, but instead of 
jumping straight into the code, Tm going to go through a planning section to help you get 
the bigger picture and understand how to create a larger program. 

Planning the Tic-Tac-Toe Game 

If you havenT figured this out by now, ITl bore you with it again: the most important part of 
programming is planning to program. Without a roadmap, youTl never get to where you want 
to go (or it’ll take you a lot longer as you travel the scenic route). 
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Writing the Pseudocode 

It’s back to your favorite language thafs not really a language: pseudocode. Since Fll be using 
functions for most of the tasks in the program, I can afford to think about the program at a 
pretty general level. Each line of pseudocode should feel like one function call. Then, later, 
ril just have to write the functions that the plan implies. Here’s the pseudocode: 

display the game instructions 
determine who goes first 
create an empty tic-tac-toe board 
display the board 

while nobody's won and it's not a tie 
if it's the hunian's turn 
get the hunian's move 
update the board with the move 
otherwise 

calculate the computer's move 
update the board with the move 
display the board 
switch turns 

congratulate the winner or declare a tie 

Representingthe Data 

Alright, 1 have a good plan, but it is pretty abstract and talks about throwing around different 
elements that aren’t really defined in my mind yet. 1 see the idea of making a move as placing 
a piece on a game board. But how exactly am 1 going to represent the game board? Or a piece? 
Or a move? 

Since fm going to print the game board on the screen, why not just represent a piece as one 
character, an "X" or an "0"? An empty piece could just be a space. The board itself should be 
a list since it’s going to change as each player makes a move. There are nine squares on a tic- 
tac-toe board, so the list should be nine elements long. Each square on the board will 
correspond to a position in the list that represents the board. Figure 6.9 illustrates what 1 mean. 


Q Figure 6.9 ) 

0 

1 

2 

Each square 
number 

3 

4 

5 

corresponds to a 
position in a List 

6 

7 

8 


that represents 
the board. 
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So, each square or position on the board is represented by a number, 0-8. That means the list 
will be nine elements long and have position numbers 0-8. Since each move indicates a square 
in which to put a piece, a move is also just a number, 0-8. 

The sides the player and computer play could also be represented by" X" and " 0", just like a game 
piece. And a variable to represent the side of the current turn would be either an " X" or an " 0". 

Creating a List of Functions 

The pseudocode inspires the different functions ITl need. 1 created a list of them, thinking 
about what they would do, what parameters they would have, and what values they would 
return. Table 6.1 shows the results of my efforts. 


Table 6.1 Tic-Tac-Toe Functions 


r 

Function 

display_instruct() 
ask _jes_no{question) 

Descriptiori 

DispLays the game instructions. 

Asks a yes or no question. Receives a question. Returns either a 
"y" ora "n". 

askjnmberi questi on, low, 
high) 

Asks for a number within a range. Receives a question, a Low 
number, and a high number. Returns a number in the range from 

lowtohigh. 

pieces() 

Determines who goes first. Returns the computer's piece and 
human’s piece. 

new_board() 

displ ayjaoardiboard) 

1 egal_moves(f)oarc/) 

Creates a new, empty game board. Returns a board. 

DispLays the board on the screen. Receives a board. 

Creates a List of LegaL moves. Receives a board. Returns a List of 

LegaL moves. 

wi r\r\er{board) 

Determines the game winner. Receives a board. Returns a piece, 

"TIE" orNone. 

hunian_nioveffjoarc/, human) 

Gets the human’s move from the pLayer. Receives a board and the 
human’s piece. Returns the human's move. 

coniputer_niove(f>oarc/, 
computer, human) 
next_turn(turn) 

CaLcuLates the computer's move. Receives a board, the computer 
piece, and the human piece. Returns the computer’s move. 

Switches turns based on the current turn. Receives a piece. 

Returns a piece. 

congrat_wi mer{the_winner, 
computer, human) 

CongratuLates the winner or decLares a tie. Receives the winning 
piece, the computer's piece, and the human’s piece. 
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Setting Up the Program 

The first thing I did in writing the program was set up some global constants. These are values 
that more than one function will use. Creating them will make the functions clearer and any 
changes involving these values easier. You can find the code for the program on the compan- 
ion website (www.courseptr.com/downloads) in the Chapter 6 folder; the file name is tic-tac- 
toe.py. 

# Tic-Tac-Toe 

# Plays the game of tic-tac-toe against a human opponent 

# global constants 
X = "X" 

0 = " 0 " 

EMPTY = " " 

TIE = "TIE" 

NUM_SQUARES = 9 

X is just shorthand for " X", one of the two pieces in the game. 0 represents " 0 ", the other piece 
in the game. EMPTY represents an empty square on the board. lt’s a space because when it’s 
printed, it will look like an empty square. TIE represents a tie game. And NUM_SQUARES is the 
number of squares on the tic-tac-toe board. 

The displayJnstructO Function 

This function displays the game instructions. YouVe seen it before; 

def display_instruct(): 

.Display game instructions.. 

print( 

II II II 

Welcome to the greatest intellectual challenge of all time: Tic-Tac-Toe. 

This will be a showdown between your human brain and my Silicon processor. 

You will make your move known by entering a number, 0 - 8. The number 
will correspond to the board position as illustrated: 

0 I 1 I 2 


3 I 4 I 5 


6 I 7 I 8 
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Prepare yourself, human. The ultimate battle is about to begin. \n 

H II II 

) 

The only thing I did was change the function name for the sake of consistency in the program. 

The ask_yes_no() Function 

This function asks a yes or no question. It receives a question and returns either a "y" or a 
" n ". YouVe seen this function before too. 

def ask_yes_no(question): 

.Ask a yes or no question.. 

response = None 

while response not in ("y", "n"): 

response = input(question).lower() 
return response 

The ask_number() Function 

This function asks for a number within a range. It receives a question, a low number, and a 
high number. It returns a number within the range specified. 

def ask_number(question, low, high): 

.Ask for a number within a range.. 

response = None 

while response not in rangedow, high): 

response = int(input(question)) 
return response 

The piecesO Function 

This function asks the player if he or she wants to go first and returns the computer’s piece 
and human’s piece, based on that choice. As the great tradition of tic-tac-toe dictates, the X’s 
go first. 

def pieces(): 

.Determine if player or computer goes first.. 

go_first = ask_yes_no("Do you require the first move? (y/n): ") 
if go_first == "y": 

print( "\nThen take the first move. You will need it.") 
human = X 
computer = 0 
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el se: 

print( "\nYour bravery will be your undoing... I will go first.") 
computer = X 
human = 0 

return computer, human 

Notice that this function calls another one of my functions, ask_yes_no( ). This is perfectly 
fine. One function can call another. 

The new_board() Function 

This function creates a new hoard (a list) with ali nine elements set to EMPTY and returns it: 

def new_board(): 

.Create new game board.. 

board = [] 

for square in range(NUM_SQUARES): 

board.append(EMPTY) 
return board 

The display_board() Function 

This function displays the hoard passed to it. Since each element in the hoard is either a space, 
the character " X", or the character " 0", the function can print each one. A few other characters 
on my keyhoard are used to draw a decent-looking tic- tac-toe board. 

def display_board(board): 

.Display game board on screen.. 

print("\n\t'', board[0], "I", board[l], "I", board[2]) 


print("\t", ".") 

print("\t". board[3], board[4], board[5]) 

print("\t", "-") 

print("\t", board[6], board[7]. board[8]. "\n") 


The legal_moves() Function 

This function receives a board and returns a list of legal moves. This function is used by other 
functions. It’s used by the human_move( ) function to make sure that the player chooses a valid 
move. It’s also used by the computer_move( ) function so that the computer can consider only 
valid moves in its decision making. 
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A legal move is represented by the number of an empty square. For example, if the center 
square were open, then 4 would be a legal move. If only the corner squares were open, the list 
of legal moves would be [0, 2, 6, 8]. (Take a look at Figure 6.9 ifyouhe unclear about this.) 

So, this function just loops over the list representing the hoard. Each time it finds an empty 
square, it adds that square number to the list of legal moves. Then it returns the list of legal 
moves. 

def 1egal_moves(board): 

.Create list of legal moves.. 

moves = [] 

for square in range(NUM_SQUARES): 
if boardisquare] == EMPTY: 
moves.append(square) 
return moves 

The winnerQ Function 

This function receives a board and returns the winner. There are four possible values for a 
winner. The function will return either X or 0 if one of the players has won. If every square is 
filled and no one has won, it returns TI E. Finally, if no one has won and there is at least one 
empty square, the function returns None. 

The very first thing 1 do in this function is define a constant called WAYS_T0_WIN, which repre- 
sents all eight ways to get three in a row. Each way to win is represented by a tuple. Each tuple 
is a sequence of the three hoard positions that form a winning three in a row. Take the first 
tuple in the sequence, (0, 1, 2). This represents the top row: board positions 0, 1, and 2. The 
next tuple (3, 4, 5) represents the middle row. And so on. 

def winner(board): 


.Determine the game 

winner 

WAYS_T0_WIN = ((0, 

1, 

2), 

(3, 

4, 

5), 

(6, 

7, 

8), 

(0, 

3, 

6), 

(1. 

4, 

7), 

(2, 

5, 

8), 

(0, 

4, 

8), 

(2, 

4, 

6)) 


Next, 1 use a for loop to go through each possible way a player can win, to see if either player 
has three in a row. The i f statement checks to see if the three squares in question all contain 
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the same value and are not empty. If so, that means that the row has either three X’s or 0’s in 
it and somebody has won. The computer assigns one of the pieces in this winning row to 
winner, returns wi nner, and ends. 

for row in WAYS_TO_WIN: 

if board[row[0]] == board[row[l]] == board[row[2]] != EMPTY: 
winner = board[row[0]] 
return winner 

If neither player has won, then the function continues. Next, it checks to see if there are any 
empty squares left on the hoard. If there aren’t any, the game is a tie (hecause the function 
has aiready determined that there is no winner, hack in the for loop) and TIE is returned. 

if EMPTY not in board: 
return TIE 

If the game isn’t a tie, the function continues. Finally, if neither player has won and the game 
isn’t a tie, there is no winner yet. So, the function returns None. 

return None 

The human_move() Function 

This next function receives a hoard and the human’s piece. It returns the square number 
where the player wants to move. 

First, the function gets a list of all the legal moves for this board. Then, it continues to ask 
the User for the square number to which he or she wants to move untii that response is in 
this list of legal moves. Once that happens, the function returns the move. 

def hunian_move(board, human): 

.Get human move.. 

legal = 1egal_moves(board) 
move = None 

while move not in legal: 

move = ask_number("Where will you move? (0 - 8):", 0, NUM_SQLIARES) 
if move not in legal: 

print( "\nThat square is aiready occupied, foolish human. Choose another.Yn") 
printCEine...") 
return move 
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The computer_move() Function 

The coniputer_niove( ) function receives the board, the computer’s piece, and the human’s 
piece. It returns the computer’s move. 



This is definiteLy the meatiest function in the program. Knowing it wouLd be, I 
initiaLLy created a short, temporary function that chooses a random but LegaL 
move. I wanted time to think about this function, but didn't want to sLow the 
progress of the entire project. So, I dropped in the temporary function and got 
the game up and running. Later, I came backand pLugged in a better function that 
actuaLLy picks moves for a reason. 

I had this fLexibiLity because of the modular design afforded by writing with 
functions. I knew that computer_move( ) was a totaLLy independent component 
and couLd be substituted Later without a probLem. In fact, I couLd even drop a 
new function in right now, one that chooses even better moves. (Sounds an awf uL 
Lot Like a chaLLenge, now doesn't it?) 


I have to be careful here because the board (a list) is mutable and I change it in this function 
as I search for the best computer move. The problem with this is that any change I make to 
the board will be reflected in the part of the program that called this function. This is the 
resuit of shared references, which you learned about in Chapter 5, in the “Understanding 
Shared References” section. Basically, there’s only one copy of the list, and any change I 
make here changes that single copy. So, the very first thing I do is make my own local copy 
to Work with: 

def computer_niove(board, computer, human): 

.Make computer move.. 

# make a copy to work with since function will be changing list 
board = board[:] 

Any time you get a mutabLe vaLue passed to a function, you have to be carefuL. If 
you know you’re going to change the vaLue as you work with it, make a copy and 
use that instead. 

You might think that changing the board wouLd be a good thing. You couLd change 
it so that it contains the new computer move. This way, you don't need to send 
the board back as a return vaLue. 

Changing a mutabLe parameter directLy Like this is considered creating a side ef¬ 
feci. Not aLL side effects are bad, but this type is generaLLy frowned upon (l'm 
frowning right now, just thinking about it). It's best to communicate with the rest 
of your program through return vaLues; that way, it's cLear exactLy what infor- 
mation you're giving back. 
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Okay, here’s the basic strategy I came up with for the computer: 

1. If there’s a move that allows the computer to win this turn, the computer should choose 
that move. 

2. If there’s a move that allows the human to win next turn, the computer should choose 
that move. 

3. Otherwise, the computer should choose the best empty square as its move. The best 
square is the center. The next best squares are the corners. And the next best squares are 
the rest. 

So next in the code, I define a tuple to represent the best squares, in order: 

# the best positions to have, in order 
BEST_MOVES = (4, 0, 2, 6, 8, 1, 3, 5, 7) 

printCI shall take square number", end='' ") 

Next, I create a list of all the legal moves. In a loop, I try the computer’s piece in each empty 
square number I got from the legal moves list and check for a win. If the computer can win, 
then thafs the move to make. If thafs the case, the function returns that move and ends. 
Otherwise, I undo the move I just tried and try the next one in the list. 

# if computer can win, take that move 
for move in legal_moves(board): 

boardLmove] = computer 
if winner(board) == computer: 
print(move) 
return move 

# done checking this move, undo it 
boardLmove] = EMPTY 

If I get to this point in the function, it means the computer can’t win on its next move. So, I 
check to see if the player can win on his or her next move. The code loops through the list of 
the legal moves, putting the human’s piece in each empty square, checking for a win. If the 
human can win, then thafs the move to take for a block. If this is the case, the function returns 
the move and ends. Otherwise, I undo the move and try the next legal move in the list. 

# if human can win, block that move 
for move in legal_moves(board): 

boardLmove] = human 
if winner(board) == human: 
print(move) 
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return move 

# done checking this move, undo it 
board[move] = EMPTY 

If I get to this point in the function, then neither side can win on its next move. So, I look 
through the list of best moves and take the first legal one. The computer loops through 
BEST_MOVES, and as soon as it finds one thafs legal, it returns that move. 

# since no one can win on next move, pick best open square 
for move in BEST_MOVES: 

if move in 1egal_moves(board): 
print(move) 
return move 


/ \ 

In THE Real World 

The Tic-Tac-Toe program considers only the next possible move in the game. Pro- 
grams that play serious games of strategy, like chess, look far deeper into the 
consequences of individual moves, considering many levels of moves and counter- 
moves. And today's computers can examine a huge number of game positions. 
Specialized machines, like IBM's chess-playing Deep Blue computer, which 
beat World Champion Garry Kasparov, can examine far more. Deep Blue is able to 
explore over 200,000,000 board positions per second. That sounds quite 
impressive, until you realize that the total number of board positions in a 
complete search for chess is estimated to be over 100,000,000,000,000,000, 
000,000,000,000,000,000,000,000,000,000,000, which means it would take Deep 
Blue more than 1,585,489,599,188,229 years to look at all those possible positions. 
(The universe, by the way, is estimated to be only 15,000,000,000 years old.) 


The next_turn() Function 

This function receives the current turn and returns the next turn. A turn represents whose 
turn it is and is either X or 0. 

def next_turn(turn): 

.Switch turns.. 

if turn == X: 


return 0 



Python Programming for the Absolute Beginner, Third Edition 



el se: 

return X 

The function is used to switch turns after one player has made a move. 

The congrat_winner() Function 

This function receives the winner of the game, the computer’s piece, and the human’s piece. 
This function is called only when the game is over, so the_wi nner will be passed either X or 0 
if one of the players has won the game, or TIE if the game ended in a tie. 

def congrat_winner(the_winner, computer, human): 

.Congratulate the winner.. 

if the_winner != TIE: 

print(the_winner, "wonlXn") 
el se: 

printCIfs a tie!\n") 
if the_winner == computer: 

printCAs I predicted, human, I am triumphant once more. \n" \ 

"Proof that computers are superior to humans in ali regards.") 

elif the_winner == human: 

printCNo, no! It cannot be! Somehow you tricked me, human. \n'' \ 

"But never again! I, the computer, so swear it!") 

elif the_winner == TIE: 

printCYou were most lucky, human, and somehow managed to tie me. \n" \ 
"Celebrate today... for this is the best you will ever achieve.") 

The main() Function 

I put the main part of the program into its own function, instead of leaving it at the globat 
level. This encapsulates the main code too. Unless you’re writing a short, simple program, it’s 
usually a good idea to encapsulate even the main part of it. If you do put your main code into 
a function like this, you don’t have to call it main (). There’s no magic to the name. But it’s a 
pretty common practice, so it’s a good idea to use it. 

Okay, here’s the code for the main part of the program. As you can see, it’s almost exactly, 
line for line, the pseudocode I wrote earlier: 
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def niain(): 

display_instruct() 
computer, human = piecesO 
turn = X 

board = new_board() 
display_board(board) 

while not winner(board): 
if turn == human: 

move = human_move(board, human) 
board[move] = human 
el se: 

move = computer_move(board, computer, human) 
board[move] = computer 
display_board(board) 
turn = next_turn(turn) 

the_winner = winner(board) 
congrat_winner(the_winner, computer, human) 

Starting the Program 

The next line calls the main function (which in turn calls the other functions) from the 
global level: 

# start the program 
main () 

input("\n\nPress the enter key to quit.") 

SUMMARY 

in this chapter, you learned to write your own functions. You then saw how to accept and 
return values in your functions. You learned about scopes and saw how global variables can 
be accessed and changed from within functions. You also learned to limit your use of global 
variables, but saw how to use global constants when necessary. You even dabbled ever so 
slightly in some artificial intelligence concepts to create a computer opponent in a game of 
strategy. 
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Challenges 

1. Improve the function ask_nuniber( ) so that the function can be 
called with a step value. Make the default value of step 1. 

2. Modify the Guess My Number chapter project from Chapter 3 
by reusing the function ask_nuniber(). 

3. Modify the new version of Guess My Numberyou created in the 
last challenge so that the program's code is in a function called 
tnainO. Don't forget to call tnainO so that you can play the 
game. 

4. Writea newcoiiiputer_move( ) functionfortheTic-Tac-Toegame 
to plug the hole in the computer's strategy. See if you can 
create an opponent that is unbeatable! 



(^C HAP TE 


Files and Exceptions: The 
Trivia Challenge Game 


V ariables provide a great way to store and access information while a pro- 
gram runs, but often, you’11 want to save data so that you can retrieve it 
later. In this chapter, you’11 learn to use files for this kind of permanent 
storage. You’11 also learn how to handle errors that your code may generate. Specif- 
ically, you’11 learn to do the following: 

• Read from text files 
• Wrife to text files 

• Read and write more complex dafa wifh files 
• Infercepf and handle errors during a program’s execufion 

Introducing THE Trivia Challenge Game 

The Trivia Challenge game fesfs a player’s knowledge with a series of multiple- 
choice quesfions. The game delivers the questions as a single “episode.” The 
episode I created to show off the program is ahout the mafia and is called “An 
Episode You Can’t Refuse.” All of the questions relate in some way to the mafia 
(although a bif indirecfly af fimes). 

The cool fhing about the game is that the questions for an episode are stored in a 
separate file, independent of fhe game code. This way, if’s easy to play different 
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ones. Even better, this means that anyone with a text editor (like Notepad on Windows 
machines) can create their own trivia episode about whatever topic they choose—anything 
from anime to zoology. Figure 7.1 shows the game (and my episode) in action. 


Q Figure/.i ^ 

The pLayer Is 
aLways presented 
with four inviting 
choices, but onLy 
one is correct. 


C:\Python31\python.exe 


HEID 


Uelcome to Trivia Challenget 
^)n Episode Vou Can't Refuse 

[Oii the Run With a Mamnal 

I.et^s say you turn state^s evidence and need to "get on the lanb." If you wait 
too long, what will happen? 

1 - Vou*11 end up on the sheep 

2 - Vou'11 end up on the cow 

3 - Vou^11 end up on the goat 

4 - You'11 end up on the enu 

[U}iat's your answer?: _ 


Reading from Text Files 

With Python, it’s easy to read strings from plain text files—files that are made up of only ASCII 
characters. (Although there are different t 5 ^es of text files, when I use the term “text file,” I 
mean a plain text file.) Text files are a good choice for permanently storing simple informa- 
tion, for a number of reasons. First, text files are cross-platform. A text file on a Windows 
machine is the same text file on a Mac and is the same text file under Unix. Second, text files 
are easy to use. Most operating systems come with basic tools to view and edit them. 

Introducing the Read It Program 

The Read It program demonstrates several ways you can read strings from a text file. The 
program demonstrates how to read anything from a singie character to the entire file. It also 
shows several different ways to read one line at a time. Figure 7.2 illustrates the program. 

The program reads a simple text file I created on my system using a text editor. You can find 
the file on the companion website (www.courseptr.com/downIoads) in the Chapter 7 folder; 
the file name is read_it.txt. Here are the contents of the file: 

Line 1 

This is line 2 
That makes this line 3 
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\m C:\Python31\python.exe 


[Opening and closing the file. 


HEID 


Reading characters from the file. 

L 

ine 1 


Reading the entire file at once. 
Line 1 

Ihis is line 2 

That makes this line 3 


Reading charactei^s from a line. 
L 

ine 1 


Reading one line at a tine. 
Line 1 


This is line 2 

iThat makes this line 3 


Reading the entii*e file into a list. 

['Line l\n', 'This is line 2Sn', 'That nakes this line 3\n'] 

3 

I.ine 1 


This is line 2 

That nakes this line 3 


r.ooping thi*ough the file, line by line. 
Line 1 


This is line 2 

That nakes this line 3 


Press the enter key to exit.. 



The fiLe is read 
using a few 
different 
techniques. 


You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 7 folder; the file name is read_it.py: 

i Read It 

# Demonstrates reading from a text file 

print("Opening and closing the file.") 
text_file = open("read_it.txt", "r") 
text_file.close() 

print( ''\nReading characters from the file.") 
text_file = open("read_it.txt", "r") 
print(text_file.read(l)) 
print(text_file.read(5)) 
text_file.close() 


print( "\nReading the enti re file at once.") 
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text_file = open( "read_it.txt", "r") 
whole_thing = text_file.read() 
print(whole_thing) 
text_file.close() 

print("\nReading characters from a line.") 
text_file = open( "read_it.txt", "r") 
print(text_file.readline(l)) 
print(text_file.readline(5)) 
text_file.close() 

print("\nReading one line at a time.") 
text_file = open( "read_it.txt", "r") 
pri nt(text_fi le.readlineO) 
pri nt(text_fi le.readlineO) 
print(text_file.readline()) 
text_file.close() 

print("\nReading the entire file into a list.") 

text_file = open( "read_it.txt", "r") 

lines = text_file.readlines() 

print(lines) 

printdendines)) 

for line in lines: 

printdine) 
text_file.close() 

print("\nLooping through the file, line by line.") 
text_file = open( "read_it.txt", "r") 
for line in text_file: 

printdine) 
text_file.close() 

input( "\n\nPress the enter key to exit.") 

ril Show you exactly how the code works through an Interactive session. 
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Opening and CLosing a File 

Before you can read from (or write to) a file, you need to open it. Thafs the first thing I do in 
the Read It program: 

>>> text_file = open( "read_it.txt" , "r") 

I use the open( ) function to open a file and assign the results to text_fi 1 e. In the function 
call, I provide two string arguments: a file name and an access mode. 

The file argument, "read_it.txt", is pretty straightforward. Since I don’t include any path 
Information, P 3 d;hon looks in the current directory for the file. I can access a file in any direc- 
tory hy providing the proper path information. 

Next, I provide "r" for the access mode, which telis Python that I want to open the file for 
reading. You can open a file for reading, writing, or both. Table 7.1 describes selected valid 
text file access modes. 



After opening the file, I access it through the variable text_f i 1 e, which represents a file object. 
There are many useful file object methods that I can invoke, but the simplest is cl ose (), which 
closes the file, sealing it off from further reading or writing until the file is opened again. 
Thafs what I do next in the program: 

>>> text_file.close() 

Whenever you’re done with a file, if s good programming practice to close it. 
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Reading Characters from a File 

For a file to be of any use, you need to do something with its contents between opening and 
closing it. So next, I open the file and read its contents with the reacK ) file object method. 
reacK ) allows you to read a specified number of characters from a file, which the method 
returns as a string. After opening the file again, I read and print exactly one character 
from it: 

>» text_file = open (''read_it.txt'', "r") 

>» print(text_file.read(l)) 

L 

All I have to do is specify the number of characters between the parentheses. Next, I read and 
print the next five characters: 

>>> print(text_file.read(5)) 
i ne 1 

Notice that I read the five characters following the " L". Python remembers where I last left 
off. It’s like the computer puts a bookmark in the file and each suhsequent read( ) hegins 
where the last ended. When you read to the end of a file, suhsequent reads return the empty 
string. 

To start back at the beginning of a file, you can close and open it. Thafs just what I did next: 

>» text_file.close() 

>» text_file = open("read_it.txt", "r") 

If you don’t specify the number of characters to be read, Python returns the entire file as a 
string. Next, I read the entire file, assign the returned string to a variable, and print the 
variable: 

>» whole_thing = text_file.read() 

>» print(whole_thing) 

Line 1 

This is line 2 
That makes this line 3 

If a file is small enough, reading the entire thing at once may make sense. Since Pve read the 
entire file, any suhsequent reads will just return the empty string. So, I close the file again: 


>» text_file.close() 
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Reading Characters from a Une 

Often, you’ll want to work with one line of a text file at a time. The readi i ne( ) method lets 
you read characters from the current line. You just pass the number of characters you want 
read from the current line and the method returns them as a string. If you don’t pass a num¬ 
ber, the method reads from the current position to the end of the line. Once you read all of 
the characters of a line, the next line becomes the current line. After opening the file again, 
1 read the first character of the current line: 

>>> text_file = open("read_it.txt", "r") 

>>> print(text_file.readline(l)) 

L 

Then 1 read the next five characters of the current line: 

>>> print(text_file.readiine(5)) 
i ne 1 

>>> text_file.close() 

Atthis point, readi i ne 0 mayseemno different than read (), but readi i ne 0 reads characters 
from the current line only, while read ( ) reads characters from the entire file. Because of this, 
readi i ne () is usually invoked to read one line of text at a time. In the next few lines of code, 
1 read the file, one line at a time: 

>>> text_file = open("read_it.txt", "r") 

>>> print(text_file.readiine()) 

Line 1 

>>> print(text_file.readiine()) 

This is line 2 

>>> print(text_file.readiine()) 

That tnakes this line 3 

>>> text_file.close() 

Notice that a blank line appears after each line. Thafs because each line in the text file ends 
with a newline character (" \n"). 
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Reading ALI Lines into a List 

Another way to work with individual lines of a text file is the readl i nes () method, which 
reads a text file into a list, where each line of the file becomes a string element in the list. 
Next, 1 invoke the readl i nes( ) method: 

>» text_file = open( ''read_it.txt'', "r") 

>» lines = text_file.readlines() 

lines now refers to a list with an element for each line in the text file: 

>» print(lines) 

['Line l\n', 'This is line 2\n', 'That makes this line 3\n'] 

lines is like any list. You can find the length of it and even loop through it: 

>» pri nt (1 en( 1 i nes)) 

3 

>» for line in lines: 
print(line) 


Line 1 

This is line 2 
That makes this line 3 
>» text_file.close() 

Looping through a File 

You can also loop directly through the lines of a file using a for loop: 

>» text_file = open("read_it.txt", "r") 

>» for line in text_file: 
print(line) 

Line 1 

This is line 2 
That makes this line 3 


>» text_file.close() 
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As you can see, the loop variable (1 i ne in this code) gets each line of the file, in succession. 
The first iteration of the loop it gets the first line; the second iteration it gets the second line; 
and so on. This technique is the most elegant solution if you want to move through a file one 
line at a time. 

Writing to a Text File 

For text files to be a viable form of storage, you need to be able to get Information into them. 
With Python, it’s also a simple matter to write strings to text files. ITl demonstrate two basic 
ways to do just that. 

Introducing the Write It Program 

The Write It program creates a text file with the same contents of the read_i t. txt file that 1 
used in the Read It program. Actually, the program creates and prints this new file twice, 
using a different file writing method each time. Figure 7.3 shows the results of the program. 
You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 7 folder; the file name is write_it.py. 


C:\Python31\python.exe 


X 

Creating a text fdle with the writeO netlmd. 



Reading the newly created file. 

Line 1 

This is line 2 

That makes this line 3 



Creating a text file with the writelinesO method. 



Reading the newlv created file. 

Line 1 

This is line 2 

That makes this line 3 



Press the enter key to exit._ 




Q Figure 7.3 ^ 

The same fiLe is 
created twice, 
each time with a 
different fiLe 
object method. 


Writing Strings to a File 

Just as before, in order to use a file, 1 have to open it in the correct mode. So, the first thing 1 
do in the program is open a file in write mode: 

# Write It 

# Demonstrates writing to a text file 

printCCreating a text file with the writeO method.") 
text_file = open("wri te_it.txt" , "w") 
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The file wri te_i t. txt springs into existence as an empty text file just waiting for the program 
to write to it. If the file wri te_i t. txt had already existed, it would have been replaced with a 
brand-new, empty file and all of its original contents would have been erased. 

Next, 1 use the wri te( ) file object method, which writes a string to the file: 

text_file.write(''Line l\n") 
text_file.write(''This is line 2\n") 
text_file.write(''That makes this line 3\n'') 

The wri te() method does not automatically insert a newline character at the end of a string 
it writes. You have to put newlines in where you want them. If 1 had left the three newline 
characters out of the previous lines of code, the program would write one, long line to 
the file. 

Also, you don’t have to end every string you write to a file with a newline character. To achieve 
the same end resuit, 1 could just as easily have stuck all three of the previous strings together 
to form one long string, " Li ne l\n This is line 2\n That makes this line 3\n", and written 
that string to the file with a single wri te( ) method. 

Finally, 1 close the file: 

text_file.close() 

Next, just to prove that the writing worked, 1 read and print the entire contents of the file: 

print("\nReading the newly created file.") 
text_file = open("wri te_it.txt". "r") 
print(text_fi1 e.read()) 
text_file.close() 

Writing a List of Strings to a File 

Next, 1 create the same file, using the wri tel i nes () file object method. Like its counterpart, 
readlines(),writelines() works with a list of strings. But instead of reading a text file into a 
list, the method writes a list of strings to a file. 

The first thing 1 do is open the file for writing: 

print( "\nCreating a text file with the writelinesO method.") 
text_file = open("write_it.txt", "w") 

1 open the same file, wri te_i t. txt, which means 1 wipe out the existing file and start with a 
new, empty one. Next, 1 create a list of strings to be written, in order, to the file: 
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lines = ["Line l\n", 

"This is line 2\n'', 

"That makes this line 3\n"] 

Again, I inserted newline characters where I want them in the text file. 

Next, I write the entire lists of strings to the file with the wri tel i nes () method: 
text_file.writelinesdines) 

Finally, 1 close the file: 
text_file.close() 

Lastly, 1 print out the contents of the file to show that the new file is exactly the same as the 
previous version: 

print( "\nReading the newly created file.") 
text_file = open("write_it.txt", "r") 
print(text_file.read()) 
text_file.close() 

input("\n\nPress the enter key to exit.") 

YouVe seen a lot of file ohject read and write methods. Take a look at Table 7.2 for a summary 
of them. 


^ Table 

7.2 Selected File Object Methods ^ 

f - 

-> 

Method 

Description 

close() 

CLoses the file. A cLosed fiLe cannot be read from or written to untiL opened 
again. 

read( [sfze]) 

Reads Sfze characters from a fiLe and returns them as a string. If size is not 
specified, the method returns alL of the characters from the current position 
to the end of the fiLe. 

readl i ne( [sfze]) 

Reads sfze characters from the current Line in a fiLe and returns them as a 
string. If size is not specified, the method returns aLL of the characters from 
the current position to the end of the Line. 

readlinesO 

Reads aLL of the Lines in a fiLe and returns them as eLements in a List. 

write(output) 

Writes the string OUtput to a fiLe. 

writeli nes(output) 

Writes the strings in the List OUtput to a fiLe. 
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Storing Complex Data in Files 

Text files are convenient because you can read and manipulate them with any text editor, 
but they’re limited to storing a series of characters. Sometimes you may want to store more 
complex Information, like a list or a dictionary, for example. You could try to convert the 
contents of these data structures to characters and save them to a text file, but Python offers 
a much better way. You can store more complex data in a file with a single line of code. You 
can even store a simple database of values in a single file that acts like a dictionary. 

Introducing the Pickle It Program 

Pickling means to preserve—and thafs just what it means in Python. You can pickle a complex 
piece of data, like a list or dictionary, and save it in its entirety to a file. Best of all, your hands 
won’t smell like vinegar when you’re done. 

The Pickle It program pickles, Stores, and retrieves three lists of strings in a binary file. It does 
this twice. First, the program picldes, Stores, and retrieves the three lists sequentially—much 
like youVe seen with characters in a text file. Next, the program Stores and retrieves the same 
three lists so that they can be randomly accessed. The results of the program are shown in 
Figure 7.4. You can find the code for the program on the companion website 
(www.courseptr.com/downloads) in the Chapter 7 folder; the file name is pickle_it.py. 



Each list is written 
to and read from a 
file in its entirety. 


| [c^ C:\Python31\python.exe 


[Unpickling lists. 

['sweet', 'hot', 'dill'] 
['whole', 'speai*', 'chip'] 
['Claussen*, 'Heinz', 'UIassie'] 


Shelving lists. 


HEID 


Pickling lints. 


Retrieving lists from a shelved file: 
brand - ['Claussen', 'Heinz', 'UIassie'] 
hape - ['whole', 'spea»*', 'ehip'] 
Iva^iety - ['sweet', 'hot', 'dill'] 


Press the enter key to exit._ 


Pickling Data and Writing It to a File 

The first thing 1 do in the program is import two new modules: 

# Pickle It 

# Demonstrates pickling and shelving data 


import pickle. 


shel ve 
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The pickl e module allows you to pickle and store more complex data in a file. The shel ve 
module allows you to store and randomly access pickled objects in a file. 

Pickling is straightforward. Instead of writing characters to a file, you can wrife a piclded 
object to a file. Piclded objects are stored in files much like characters; you can store and 
retrieve them sequentially. First, 1 create the three lists that 1 plan to pickle and write to 
a file. 

print("Pickling lists.") 
variety = ["sweet", "hot", "dill"] 

shape = ["whole", "spear", "chip"] brand = ["Claussen", "Heinz", "Vlassic"] 

Next, 1 open the new file to store the pickled lists. 
f = openCpicklesl.dat", "wb") 

Pickled objects must be stored in a binary file—they can’t be stored in a text file. So, 1 open a 
new binary file named picklesl.dat for writing by passing "wb" as the file access mode. 
Table 7.3 lists useful binary file access modes. 



Nexf, 1 pickle and store the three lists vari ety, shape, and brand in the file picklesl.dat using 
the pi ckl e. dump( ) function. The function requires two arguments: the data to pickle and the 
file in which fo store it. 
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pickle.dump(variety, f) 
pickle.dump(shape, f) 
pickle.dump(brand, f) 
f.closeO 

So, this code pickles the list referred to by vari ety and writes the whole thing as one object 
to the file picklesl.dat. Next, the program pickles the list referred to by shape and writes the 
whole thing as one object to the file. Then, the program pickles the list referred to by brand 
and writes the whole thing as one object to the file. Finally, the program closes the file. 

You can pickle a variety of objects, including: 

• Numbers 

• Sfrings 

• Tuples 

• Lists 

• Dictionaries 

Reading Data from a File and Unpickling It 

Next, 1 retrieve and unpiclde the three lists with the pickle.load( ) fnnction. The function 
takes one argument: the file from which to load the next pickled object. 

print( "\nUnpickl ing lists.") 
f = openCpicklesl.dat", "rb") 
variety = pickle.load(f) 
shape = pickle.load(f) 
brand = pickle.load(f) 

The program reads the first pickled object in the file, unpickles it to produce the list [" sweet", 
"hot" , "di 11 " ], and assigns the list to vari ety. Next, the program reads the next pickled object 
from the file, unpickles it to produce the list ["whole", "spear", "chip"], and assigns the list 
to shape. Finally, the program reads the last pickled object from the file, unpickles it to pro¬ 
duce the list ["Cl aussen", "Heinz", "VI assic"], and assigns the list to brand. 

Finally, 1 print the unpickled lists to prove that the process worked: 

print(variety) 
print(shape) 
print(brand) 
f.closeO 
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Table 7.4 describes selected pi ckl e functions. 


r 

Table 7.4 Selected pickle Functions ^ 

/- 

- > 

Function 

Description 

dumplobject. 

file, [ ,bin] ) Writes pickled version of object to fi 1 e. If bi n is True, object is 
written in binary format. If bi n is Fal se, Object is written in Less 
efficient, but more human- readable, textformat.Thedefaultvalue 
of bi n is equal to Fal se. 

load(file) 

Unpickles and returns the next pickled object in fi 1 e. 




Using a Shelf to Store Pickled Data 

Next, I take the idea of pickling one step further by shelving the lists together in a single file. 
Using the shel ve module, I create a shelf that acts like a dictionary, which provides random 
access to the lists. 

First, 1 create a shelf, s: 

print( "\nShel ving lists.") 
s = shel ve.open( "pickl es2.dat'' ) 

The shel ve. open( ) functionworks alotlike the file open( ) function. However, the shel ve. open 
() function works with a file that Stores pickled objects and not characters. In this case, 1 
assigned the resulting shelf to s, which now acts like a dictionary whose contents are stored 
in a file or group of files. 

Whenyou caLLshelve.open(), Python may add an extension to the file nameyou 
specify. Python may also create additionaL files to support the newLy created 
shelf. 



The shel ve. open () function requires one argument: a file name.lt also takes an optional access 
mode. If you don’t supply an access mode (like 1 didn’t), it defaults to "c". Tahle 7.5 details 
access modes for the function. 

Next, 1 add three lists to the shelf: 

s["variety"] = ["sweet", "hot", "dill"] 
s[''shape''] = ["whole", "spear", "chip"] 
s["brand"] = ["Claussen", "Heinz", "Vlassic"] 
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pickles Works like a dictionary. So, the key "variety" is paired with the value ["sweet", 
"hot", "di 11"]. The key "shape" is paired with the value [ "whol e", "spear", "chip"]. Andthe 
key "brand" is paired with the value ["Cl aussen", "Heinz", "Vlassic"] One important thing 
to note is that a shelf key can only be a string. 

Lastly, 1 invoke the shelf s sync( ) method: 

s.syncO # make sure data is written 

Python writes changes to a shelf file to a buffer and then periodically writes the buffer to the 
file. To make sure the file reflects all the changes to a shelf, you can invoke a shelf s sync() 
method. A shelf file is also updated when you close it with its cl ose( ) method. 

WhiLe you couLd simulate a shelf by pickling a dictionary, the shel ve module is 
more memory efficient. So, if you need random access to pickled objects, create 
a shelf. 



Using a Shelf to Retrieve Pickled Data 

Since a shelf acts like a dictionary, you can randomly access pickled objects from it by sup- 
plying a key. To prove this, 1 access the piclded lists in s in reverse order: 

print( "\nRetrieving lists from a shelved file:") 
printCbrand s["brand"]) 

printCshape s["shape"]) 

printCvariety s[''variety"]) 

Finally, 1 close the file; 

s.closeO 


input( "\n\nPress the enter key to exit.") 
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/ \ 

In THE Real World 

Pickling and unpickling are good ways to store and retrieve structured Information, 
but more complex Information can require even more power and flexibility. 
DatabasesandXMLaretwo popularmethodsforstoringand retrieving more complex 
data, and Python has modules that can work with either. To learn more, visit the 
Python language website at http://www.python.org. 


Handling Exceptions 

When Python runs into an error, it stops the current program and displays an error message. 
More precisely, it raises an exception, indicating that, well, something exceptional has 
occurred. If nothing is done with the exception, Python halts what it’s doing and displays an 
error message detailing the exception. 

Here’s a simple example of Python raising an exception: 

»> nutn = floatCHi!") 

Traceback (most recent call last): 

File "kpyshel , line 1, in <module> 
num = floatCHi!") 

ValueError: could not convert string to float: Hi i 

In this Interactive session, Python tries to convert the string "Hi i " to a floating-point numher. 
Since it can’t, Python raises an exception and displays the details. 

Using Python’s exception handling functionality, you can intercept and handle exceptions 
so that your program doesn’t end abruptly (even if a user enters "Hi 1 " when you ask for a 
numher). At the very least, you can have your program exit gracefully instead of crashing 
awlcwardly. 

Introducing the Handle It Program 

The Handle It program opens itself up to exceptions from user input and then purposely 
generates a few exceptions of its own. But instead of halting, the program runs to completion. 
Thafs hecause the program handles the exceptions that are raised. Figure 7.5 shows the pro¬ 
gram in action. You can find the code for the program on the companion website 
(www.courseptr.com/downloads) in the Chapter 7 folder; the file name is handle_it.py. 
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ALthough the 
program can't 
convert "Hi !" toa 
number, it doesn’t 
halt when 
exceptions are 
raised. 


\m C:\Python31\python.exe 


Fntei* a numbei*: Hit 
[That was not a numbert 


Attempting to convert None —> Sonething went wrong? 
(^tteinpting to convert Hit —> Sonething went wrongt 


(^ttenpting to convert None 
nttenpting to convert Hit - 


HEID 


Enter a nimber: Hi? 
Sonething went wrongt 


—> I can only convert a string or a nunbert 
’> I can onlv convert a string of digitst 


Enter a number: Hit 

iThat was not a nunbert Or as Python would say... 
could not convert string to float: Hit 


Enter a number: 5.6 
IVou entered the number 5.6 


Press the enter key to exit._ 


Using a try Statement with an except Clause 

The most basic way to handle (or trap) exceptions is to use the try statement with an except 
clause. By using a try statement, you section off some code that could potentially raise an 
exception. Then, you write an except clause with a block of statements that are executed only 
if an exception is raised. 

The first thing I do in the Handle It program is ask the user for a number. I get a string from 
the user and then attempt to convert the string to a floating-point number. I use try and 
except to handle any exceptions that might be raised in the process. 

# Handle It 

# Demonstrates handling exceptions 

# try/except 
try: 

num = floatdnputCEnter a number: ")) 
except: 

print("Something went wrong!") 

If the call to fl oat( ) raises an exception (as a resuit of the user entering an unconvertible 
string, like "Hi !", for example), the exception is caught and the user is informed that Something 
went wrong ! If no exception is raised, num gets the number the user entered and the program 
skips the except clause, continuing with the rest of the code. 
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Specifying an Exception Type 

Different kinds of errors resuit in different t 5 ^es of exceptions. For example, trying to convert 
the string "Hi !" with fl oat( ) results inaValueError exception because the characters in the 
string are of the wrong value (they’re not digits). There are over two dozen exception types, 
but Table 7.6 lists a few of the most common ones. 


r 

Table 7.6 Selected Exception Types ^ 

f - 

-> 

Exception Type 

Description 

lOError 

Raised when an l/O operation faiLs, such as when an attempt is made to open a 


nonexistent file in read mode. 

IndexError 

Raised when a sequence is indexed with a number of a nonexistent element. 

KeyError 

Raised when a dictionary key is not found. 

NameError 

Raised when a name (of a variable or function, for exampLe) is not found. 

SyntaxError 

Raised when a syntax error is encountered. 

TypeError 

Raised when a buiLt-in operation or function is appLied to an object of 


inappropriate type. 

ValueError 

Raised when a buiLt-in operation or function receives an argument that has the 


right type but an inappropriate value. 

1 ZeroDi vi Si onError Raised when the secondargumentof a divisionor modulo operation is zero. 1 




The except clause lets you specify exactly which type of exceptions it will handle. To specify 
a single exception t 5 rpe, you just list the specific t 5 ^e of exception after except. 

1 again ask the user for a number, but this time 1 specifically trap for aValueError: 

# specifying exception type 
try: 

num = float(input("\nEnter a number: ")) 
except ValueError: 

printCThat was not a number!") 

Now, the pri nt function will only execute if a Val ueError is raised. As a resuit, 1 can be even 
more specific and display the message That was not a number! However, if any other type of 
exception is raised inside the try statement, the except clause will not catch it and the pro- 
gram will come to a halt. 
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It’s good programming practice to specify exception types so that you handle each individual 
case. In fact, it’s dangerous to catch all exceptions the way I did in the first except clause of 
the program. Generally, you should avoid that t 5 rpe of catchall. 

When shouLdyou trap for exceptions? AnypointofexternaLinteractionwithyour 
program is a good pLace to think about exceptions. It's a good idea to trap for 
exceptions when opening a file for reading, even if you beLieve the file aLready 
exists. You can also trap for exceptions when you attempt to convert data from 
an outside source, Like the user. 

So, Let's say you know you want to trap for an exception, but you’re not exactLy 
sure what the exception type is caLLed. WeLL, here’s a shortcut for finding out: 
just create the exception. ForexampLe, ifyou knowyou want to trap fora division- 
by-zero exception, but can't remember exactLy what the exception type is caLLed, 
jump into the interpreter and divide a number by zero: 

»> 1/0 

Traceback (most recent call last): 

File "<pyshel 1#0>", line 1, in <tiiodule> 

1/0 

ZeroDivisionError: int division or modulo by zero 

From this Interactive session, I can see that the exception is caLLed 
ZeroDi vi si onError. FortunateLy, the interpreter isn’t shy about teLLing you 
exactLy which type of exception you raise. 

Handling Multiple Exception Types 

A single piece of code can resuit in different types of exceptions. Fortunately, you can trap 
for multiple exception types. One way to trap for multiple exception types is to list them in 
a single except clause as a comma-separated group enclosed in a set of parentheses: 

# handle multiple exception types 
pri nt() 

for value in (None, "Hi!"): 
try: 

print("Attempting to convert", value, end=" ") 

print(float(value)) 
except (TypeError, ValueError): 
printCSomething went wrong!") 
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This code tries to convert two different values to a floating-point number. Both fail, but each 
raises a different exception type, fl oat (None) raises a TypeError because the function can only 
convert strings andnumbers. fl oat( "Hi !") raises a Val ueError because, while "Hi !" is astring, 
the characters in the string are of the wrong value (they’re not digits). As a resuit of the 
except clause, each t 3 rpe of exception is handled. 

Another way to catch multiple exceptions is with multiple except clauses. You can list as many 
except clauses as you like, following a single try statement: 

print() 

for value in (None, "Hi!"): 
try: 

printCAttempting to convert", value, end=" ") 

print(float(value)) 
except TypeError: 

printCI can only convert a string or a number!") 
except ValueError: 

printCI can only convert a string of digitsl") 

Now, each exception type has its own block. So when val ue is None, a TypeError is raised and 
the string "I can only convert a string or a number! " is printed. When val ue is "Hi 1 ", a 
Val ue Error is raised and the string "I can only convert a string of digits! " is printed. 

Using multiple except clauses allows you to define unique reactions to different types of 
exceptions from the same try hlock. In this case, 1 offer a more specific error message hy 
trapping each exception type individually. 

Getting an Exceptiones Argument 

When an exception occurs, it may have an associated value, the exception’s argument. The 
argument is usually an official message from Python describing the exception. You can receive 
the argument if you specify a variable after the exception type, preceded by the keyword as. 
Here, 1 receive the exception’s argument in variahle e and print it out along with my regular 
error message: 

# get an exception's argument 
try: 

num = float(input(''\nEnter a number: ")) 
except ValueError as e: 

printCThat was not a number! Or as Python would say...") 
print(e) 
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Adding an else Clause 

You can add a single else clause after all the except clauses in a try statement. The el se block 
executes only if no exception is raised in the t ry block. 

# try/except/else 
try: 

num = float(input("\nEnter a number: ")) 
except ValueError: 

printCThat was not a number!") 
el se: 

printCYou entered the number", num) 
input( "\n\nPress the enter key to exit.") 

In this code, num is printed in the el se block only if the assignment statement in the try block 
doesn’t raise an exception. This is perfect because that means num will be printed only if the 
assignment statement was successful and the variable exists. 

Back to THE Trivia Challenge Game 

With the basies of files and exceptions under your belt, it’s time to tackle the Trivia Challenge 
game presented at the beginning of the chapter. One of the cool things about the program is 
that it reads a plain text file, so you can create your own trivia game episodes with a text 
editor and a dash of creativity. As youTl see in the code, the text file the program reads, 
trivia, txt, needs to be in the same directory as the program file. To create your own episode 
full of questions, all you need to do is replace this file with one containing your own work. 

Understanding the Data File Layout 

Before 1 go over actual code from the game, you should understand exactly how the trivia.txt 
file is structured. The very first line in the file is the title of the episode. The rest of the file 
consists of blocks of seven lines for each question. You can have as many blocks (and thus 
questions) as you like. Here’s a generic representation of a block: 

<category> 

<question> 

<answer 1> 

<answer 2> 

<answer 3> 

<answer 4> 

<correct answer> 

<explanation> 
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And here’s the beginning of the file I created for the game: 

An Episode You Can't Refuse 
On the Run With a Mammal 

Let's say you turn state's evidence and need to "get on the lamb. " If you 
cr wait /too long, what will happen? 

You'll end up on the sheep 
You'll end up on the cow 
You'll end up on the goat 
You'll end up on the etnu 
1 

A lamb is just a young sheep. 

The Godfather Will Get Down With You Now 

Let's say you have an audience with the Godfather of Soul. How would it be 
/smart to address him? 

Mr. Richard 
Mr. Domino 
Mr. Brown 
Mr. Checker 
3 

James Brown is the Godfather of Soul. 

To save space, I only show the first 15 lines of the file—two questions’ worth. You can take 
a look at the complete file, trivia.txt, which is on the companion website (www.courseptr.com/ 
downloads) in the Chapter 7 folder. 

Remember, the very first line in the file, An Episode You Can't Refuse, is the episode title for 
this game. The next seven lines are for the first question. And the next seven lines are for the 
second question. So, the line On the Run With a Mammal is the category of the first question. 
The category is just a elever way to introduce the next question. The next line, Let's say you 
turn state's evidence and need to "get on the lamb." If you wait /too long, what will 
happen?, is the first question in the game. The next four lines, You' 11 end up on the sheep, 
You'll end up on the cow,You'll end up on the goat, and You'11 end up on the emu,arethe 
four possihle answers from which the player will choose. The next line, 1, is the number of 
the correct answer. So in this case, the correct answer to the question is the first answer, 
You'll end up on the sheep. The next line, A lamb is just a young sheep., explains why the 
correct answer is correct. The rest of the questions follow the same pattern. 

An important thing to note is that 1 included a forward slash (/) in two of the lines. 1 did this 
to represent a newline since Python does not automatically wrap text when it prints it. When 
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the program reads a line from the file, it replaces all of the forward slashes with the newline 
character. You’ll see exactly how the program does this when 1 go over the code. 

The open_file() Function 

The first thing 1 do in the program is define the function open_fi 1 e( ), which receives a file 
name and mode (both strings) and returns a corresponding file object. 1 use try and except to 
trap for an lOError exception for input-output errors, which would occur if the file doesnT 
exist, for example. 

If 1 trap an exception, that means there was a problem opening the trivia file. If this happens, 
there’s no point in continuing the program, so 1 print an appropriate message and call the 
sys. exi t () function. This function raises an exception that results in the termination of the 
program. You should only use sys.exitO as a last resort, when you must end a program. 
Notice that 1 had to import the sys module to call sys. exi t(). 

# Trivi a Chal1enge 

# Trivia game that reads a plain text file 
import sys 

def open_file(file_name, mode): 

.Open a file.. 

try: 

the_file = open(file_name, mode) 
except lOError as e: 

printCUnable to open the file", file_name, "Ending program.\n", e) 
input( ''\n\nPress the enter key to exit.") 
sys.exitO 
el se: 

return the_file 

The next_line() Function 

Next, 1 define the next_l i ne( ) function, which receives a file object and returns the next line 
of text from it: 

def next_line(the_file): 

.Return next line from the trivia file, formatted.. 

line = the_file.readline() 
line = 1ine.repiace(, "\n") 
return line 
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However, I do one small bit of formatting to the line before I return it. I replace ali forward 
slashes with newline characters. 1 do this because Python does not automatically word wrap 
printed text. My procedure gives the creator of a trivia text file some formatting control. He 
or she can indicate where newlines should go so that words don’t get split across lines. Take 
a look at the triva.txt file and the output of the Trivia Challenge game to see this in action. 
Try removing the forward slashes from the text file and check out the results. 

The next_block() Function 

The next_bl ock( ) function reads the next block of lines for one question. It takes a file object 
and returns four strings and a list of strings. It returns a string for the category, question, 
correct answer, and explanation as well as a list of four strings for the possible answers to the 
question. 

def next_block(the_file): 

.Return the next block of data from the trivia file.. 

category = next_line(the_fi1 e) 

question = next_line(the_fi1 e) 

answers = [] 
for i in range(4): 

answers.appendinext_line(the_file)) 

correct = next_line(the_file) 
if correct: 

correct = correctLO] 

explanation = next_line(the_fi1 e) 

return category, question, answers, correct, explanation 

If the end of the file is reached, reading a line returns the empty string. So, when the program 
comes to the end of trivia.txt, category gets the empty string. 1 check category in the mai n() 
function of the program. When it becomes the empty string, the game is over. 

The weLcomeO Function 

The wel cornei ) function welcomes the player to the game and announces the episode’s title. 
The function gets the episode title as a string and prints it along with a welcome message. 
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def welconie(title): 

.Welcome the player and get his/her name.. 

print( "\t\tWel come to Trivia Challenge!\n") 
print("\t\t". title, "\n") 

Setting Up the Game 

Next, I create the ma i n () function, which houses the main game loop. In the first part of the 
function, I set up the game by opening the trivia file, getting the title of the episode (the first 
line of the file), welcoming fhe player, and setfing fhe player’s score fo 0. 

def main(): 

trivia_file = open_file(''trivia.txt". "r") 
title = next_line(trivia_file) 
welcome(title) 
score = 0 

Asking a Question 

Next, I read the first block of lines for the first question into variables. Then, I start the 
whi 1 e loop, which will continue to ask questions as long as category is not the empty string. 
If category is the empty string, that means the end of the trivia file has been reached and the 
loop won’t be entered. I ask a question by printing the category of the question, the question 
itself, and the four possible answers. 

# get first block 

category, question, answers, correct, explanation = next_block(trivia_fi1 e) 
while category: 

# ask a question 
print(category) 
print(question) 
for i in range(4): 

print( "Xt", i + 1, answersLi]) 

Getting an Answer 

Next, I get the player’s answer: 

# get answer 

answer = inputCWhafs your answer?: ") 
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Checking an Answer 

Then, I compare the player’s answer to the correct answer. If they match, the player is con- 
gratulated and his or her score is increased by one. If they don’t match, the player is told he 
or she is wrong. In either case, I then display the explanation, which describes why the correct 
answer is correct. Lastly, I display the player’s current score. 

# check answer 

if answer == correct: 

print( "\nRight !", end=" ") 
score += 1 
el se: 

print( "\nWrong. ", end=" ") 
print(explanation) 
printCScore:", score, "\n\n") 

Getting the Next Question 

Then, I call the next_bl ock() function and get the block of strings for the next question. If 
there are no more questions, category will get the empty string and the loop won’t continue. 

# get next block 

category, question, answers, correct, explanation = next_block(trivia_file) 

Ending the Game 

After the loop, I close the trivia file and display the player’s score: 
trivia_file.close() 

printCThat was the last question!") 
print("You're final score is", score) 

Startingthe mam() Function 

The last lines of code start ma i n ( ) and kick off the game: 


main() 

input("\n\nPress the enter key to exit.") 
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SUMMARY 

In this chapter, you learned about files and exceptions. You learned how to read from text 
files. You saw how to read a single character or an entire file at once. You learned several 
different ways to read one full line at a time, probably the most common way to read a text 
file. You also learned how to write to text files—everything from a single character to a list of 
strings. Next, you learned how to save more complex data to files through piclding and how 
to manage a group of pickled ohjects in a single hinary file using a shelf. Then, you saw how 
to handle exceptions raised during the execution of a program. You saw how to trap for 
specific exceptions and how to write code to deal with them. Finally, you saw how to put files 
and exceptions together through the construction of a trivia game program that allows any- 
one with a text editor to create their very own trivia episodes. 


* ' 

Challenges 

1. Improve the Trivia Challenge game so that each question has a 
uniquepointvalueassociated with it.Theplayer'sscoreshould 
be the total of all the point values of the questions he or she 
answers correctly. 

2. Improve the Trivia Challenge game so that It maintains a high- 
scores list in a file. The program should record the player's 
name and score if the player makes the list. Store the high 
scores using a pickled object. 

3. Change the way the high-scores functionality you created in 
the last challenge is implemented. This time, use a plain text 
file to store the list. 

4. Create a trivia game episode that tests a player's knowledge of 
Python files and exceptions. 



CHAPTERJ 

□ 


Software Objects: The 
Critter Caretaker 
Program 


O bject-Oriented programming (OOP) is a different way of thinking about pro- 
gramming. It’s a modern methodology thafs been embraced by the Soft¬ 
ware industry and is used in the creation of the majority of new, 
commercial Software. The basic building block in OOP is the Software object—often 
just called an object. In this chapter, youTl take your first steps toward under- 
standing OOP as you learn about objects. Specifically, youTl learn to do the 
following: 

• Create classes to detine objects 
• Write methods and create attributes for objects 
• Instantiate objects from classes 
• Restrict access to an objecfs attributes 

Introducing THE Critter Caretaker Program 

The Critter Caretaker program charges the user with the care of his or her own 
Virtual pet. The user names the critter and is completely responsible for keeping 
it happy, which is no small task. The user must feed and play with the critter to 
keep it in a good mood. The user can listen to the critter to learn how the critter 
is feeling, which can range from happy to mad. Figures 8.1 through 8.3 show off 
the Critter program. 
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Q FigureS.i ^ 

You get to name 
your vety own 
critter. 


Figure8.2 ^ 

If you faiL to feed 
or entertain your 
critter. It wlLL have 
a mood change for 
the worse. 


Q Figure8.3 ^ 

But with the 
proper care, your 
critter wlLL come 
back to its orIginaL, 
sunny mood. 
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Though you could create this program without Software objects, I created the critter as an 
object. Ultimately, this makes the program easier to work with and modify. Plus, it allows for 
painless scaling. Once you’ve created one critter, it’s no sweat to create and manage a dozen. 
Could a critter farm be far off? (Not if you check the chapter challenges.) 

Understanding Object-Oriented Basics 

OOP has a reputation for being complicated, but I think it’s actually simpler than some of 
the concepts youVe already learned. In fact, OOP allows you to represent things in your pro- 
grams in a way thafs more like the real world. 

What you often want to represent in your programs—anything from a checldng account to 
an alien spacecraft—are real-life objects. OOP lets you represent these real-life objects as Soft¬ 
ware objects. Like real-life objects, Software objects combine characteristics (called attributes 
in OOP-speak) and behaviors (called methods in OOP-speak). For example, if you were to create 
an alien spacecraft object, its attributes could include its location and energy level, while its 
methods could include its ability to move or fire its weapons. 

Obj ects are created (or instantiated in OOP-speak) from a definition called a dass—programming 
code that can define attributes and methods. Classes are like blueprints. A class isn’t an object, 
it’s a design for one. And just as a foreman can create many houses from the same hlueprint, 
a programmer can create many obj ects from the same class. As a resuit, each obj ect (also called 
an instance) instantiated from the same class will have a similar structure. So, if you have a 
checldng account class, you could use it to create multiple checldng account objects. And 
those different objects would each have the same basic structure. Each might have a balance 
attribute, for example. 

But just as you can take two houses built from the same blueprint and decorate them differ- 
ently, you can have two objects of the same class and give each its own unique set of attribute 
values. So, you could have one checldng account object with a balance attribute of 100 and 
another with a balance attribute of 1,000,000. 

Don't worry if aLL this OOP taLk isn't crystaL cLearyet. I just wanted to give you an 
OverView of what objects are aLL about. Like aLL new programming concepts, 
reading about them isn't enough. But after seeing some reaL Python code that 
defines cLasses and creates objects (and coding some on your own), youlL soon 
"get" OOP. 
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Creating Classes, Methods, and Objects 

To build an object, you first need a blueprint, or a class. Classes almost always include meth- 
ods, things that an object can do. You can create a class without any methods, but that 
wouldn’t be much fun. 


Introducing the Simple Critter Program 

The Simple Critter program includes your first example of a class written in Python. In it, 1 
define an extremely simple type of critfer thaf can only do one thing: say hi. While fhis kind 
of crifter might be simple, at least it’s polite. The results of fhe program are picfured in 
Figure 8.4. 



When the program 
invokes the 
Critter objects 
tal k( ) method, 
the critter greets 
the World. 


1^1 C:\Python31\python 


|U}iat do you want to name youj» cj‘itte»'?: Larry 
Critter Caretaker 


Icho ice: 


.exe 




0 - Quit 

1 - Listen to your critter 

2 - Feed your critter 

3 - Play with your critter 


You can find fhe code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 8 folder; the file name is simple_crifter.py. The program itself is 
quite short. 

# Simple Critter 

# Demonstrates a basic class and object 

class Critter(object): 

.A Virtual pet. 

def talk(self): 

printCHi. Tm an instance of class Critter.") 


# main 

cri t = Cri tter() 
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crit.talk() 


input(''\n\nPress the enter key to exit.") 


Defining a Class 

The program starts with a class definitiori, the hlueprint of my first critter. The first line of 
the definition is the class header: 

class Critter(object): 

1 used the ke 5 word class followed by the class name 1 chose, Critter. YouTl notice that my 
class name begins with a capital letter. Python doesn’t require this, but it’s the Standard 
convention, so you should begin all your class names with a capital letter. 

Next, 1 told Python to base my class on object, a fundamental, built- in type. You can base a 
new class on object or any previously defined class, but thafs a topic for Chapter 9, “Object- 
Oriented Programming: The Blackjack Game.” In this chapter, 1 base all of my classes on 

object. 

The next line is a docstring, which documents the class. A good docstring describes the kind 
of objects a class can be used to create. My docstring is pretty straightforward: 

.A Virtual pet. 


Defining a Method 

The last part of the class detines a method. It looks very much like a function; 
def talk(self): 

printCHi. rtn an instance of class Critter.") 

In fact, you can think of methods as functions associated with an object. (YouVe already seen 
this with string and list methods, for example.) The tal k( ) method prints the string "Hi. Tm 
an instance of class Critter." 

YouTl notice that talkO has one parameter, self (which it doesnT happen to use). Every 
instance method—a method that every object of a class has—must have a special first parameter, 
called sel f by convention. This parameter provides a way for a method to refer to the object 
itself. For now, don’t worry about self, youTl see it in action a little later in this chapter. 



If you create an instance method without any parameters,you’LLgenerate an error 
when you invoke it. Remember, aLL instance methods must have a special first 
parameter, called sel f by convention. 
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Instantiating an Object 

After I wrote my class, instantiating a new object took just one line: 

cri t = Cri tter() 

This line creates a brand-new object of the Critter class and assigns it to the variable erit. 
Notice the parentheses after the class name Critter in the assignment statement. lt’s critical 
to use them if you want to create a new object. 

You can assign a newly instantiated object to a variable with any name. The name doesn’t 
have to be based on the class name. However, you should usually avoid using the same name 
in lowercase letters as the class name because it could lead to confusion. 

Invoking a Method 

My new obj ect has a method called t a 1 k (). The method is like any other method you’ve already 
seen. lt’s basically a function that belongs to the object. 1 can invoke this method just like any 
other, using dot notation: 

crit.talk() 

The line invokes the tal k( ) method of the Cri tter ohject assigned to cri t. The method simply 
prints the string " Hi. Tm an instance of class Critter." 

Using Constructors 

YouVe seen how you can create methods, like tal k( ), hut there’s a special method you can 
write, called a constructor, that is automatically invoked right after a new object is created. A 
constructor method is extremely useful. In fact, youTl often write one for each class you 
create. The constructor method is usually used to set up the initial attribute values of an 
object, though 1 won’t use it for that in this program. 

Introducing the Constructor Critter Program 

The Constructor Critter program defines a new Critter class that includes a simple construc¬ 
tor method. The program also shows how easy it is to create multiple ohjects from the same 
class. Figure 8.5 shows a sample run of the program. 
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Two separate 
critters are 
created.Each 
says hi. 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 8 folder; the file name is constructor_critter.py. 

# Constructor Critter 

# Demonstrates constructors 

class Critter(object): 

.A Virtual pet. 

def _init_(self): 

printCA new critter has been born!") 

def talk(self): 

print("\nHi. Tm an instance of class Critter.") 

# main 

critl = Critter() 
crit2 = Critter!) 

critl.talk() 
crit2.talk() 


input(''\n\nPress the enter key to exit.") 
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Creating a Constructor 

The first new piece of code in the class definition is the constructor method (also called the 
initialization method): 

def _init_(self): 

printCA new critter has been born!") 

Normally, you make up your own method names, but here I used a specific method name 
recognized by P 5 hhon. By naming the method_ i n i t _, I told P 5 hhon that this is my con¬ 
structor method. As a constructor method,_ ini t _() is automatically called by any newly 

created Critter object right after the object springs to life. As you can see from the second 
line in the method, that means any newly created Critter object automatically announces 
itself to the World by printing the string " A new critter has been born!". 

Python has a coLLection of buiLt-in "speciaL methods" whose names begin and 
end with two underscores, Like _i ni t_, the constructor method. 



Creating Multiple Objects 

Once you’ve written a class, creating multiple objects is a snap. In the main part of the pro- 
gram, 1 create two: 

# main 

critl = Critter() 
crit2 = Critter() 

As a resuit, two objects are created. Just after each is instantiated, it prints "A new critter 
has been born i" through its constructor method. 

Each object is its very own full-fledged critter. To prove the point, 1 invoke their talkO 
methods: 

cri tl.talk() 
cri t2.talk() 

Even though these two lines of code print the exact same string, " \ n H i. Tm an instance of 
class Critter.", each is the resuit of a different object. 
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UsiNG Attributes 

You can have an objecfs attributes automatically created and initializedjust after it’s instan- 
tiated through its constructor method. This is a big convenience and something you’ll do 
a lot. 

Introducing the Attribute Critter Program 

The Attribute Critter program creates a new type of object with an attribute, name. The Crit¬ 
ter class has a constructor method that creates and initializes name. The program uses the 
new attribute so that the critter can offer a more personalized greeting. Figure 8.6 shows the 
program in action. 




This time, each 
Cri tter object 
has an attribute 
name that it uses 
when it says hi. 


The following is the code for the program: 

# Attribute Critter 

# Demonstrates creating and accessing object attributes 

class Critter(object): 

.A Virtual pet. 

def init (self, name): 

printCA new critter has been born!") 
self.name = name 

def str (self): 

rep = "Critter object\n" 

rep -i-= "name: " -i- self.name -i- "\n" 
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return rep 


def talk(self): 

printCHi. rm", self.name, "\n") 


# main 

critl = CritterCPoochie") 
cri tl.talk() 

crit2 = CritterCRandolph") 
crit2.talk() 

print("Printing critl:") 
print(critl) 

print("Directly accessing critl.name:") 
print(critl.name) 

input( "\n\nPress the enter key to exit.") 

Initializing Attributes 

The constructor in this program prints the message "A new critter has been born !" just like 
the constructor in the Constructor Critter program, but the next line of the method does 
something new. It creates the attribute name for the new object and sets it to the value of the 
parameter name. So, in the main part of the program, the line: 

critl = CritterCPoochie") 

results in the creation of a new Cri tter object with an attribute name set to "Poochi e". Finally, 
the object is assigned to cri t. 

So that you can understand exactiy how this works, FII reveal what the mysterious self 
parameter is ali about. As the first parameter in every method, self automatically receives a 
reference to the object involdng the method. This means that, through sel f, a method can 
get at the object invoking it and access the objecfs attributes and methods (and even create 
new attributes for the object). 

You can name the first parameter in a method header something other than 
sel f, but you shouLdn't. It's the "Pythonic" way to do things and other program- 
mers wiLL expect it. 
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So, back in the constructor method, the parameter sel f automatically receives a reference to 
the new Cri tter object while the parameter name receives "Poochi e". Then, the line: 

self.name = name 

creates the attribute name for the object and sets it to the value of name, which is "Poochie". 

Back in the main part of the program, the assignment statement assigns this new object to 
erit. This means that erit refers to a new object with its own attribute called name set to 
"Pooehie". So, acritter has heen created with its own name! 

The line in the main program: 

crit2 = CritterCRandolph") 

kicks off the same basic chain of events. But this time, a new Cri tter object is created with 
its own attribute name set to " Rando 1 ph ". And the object is assigned to eri 12 . 

Accessing Attributes 

Attributes aren’t any good unless you can use them, sol wrote a more personal t a 1 k () method 
that uses a Cri tter ohjecfs name attribute. Now, when a critter says hi, it introduces itselfwith 
its name. 

1 got my first critter to say hi hy involdng its tal k( ) method with 
critl.talk() 

The talkO method receives the automatically sent reference to the object into its self 
parameter: 

def talk(self): 

Then, the pri nt function displays the text Hi. Tm Pooehie by accessing the attribute name of 
the object through self.name: 

printCHi. Tm", self.name, "\n") 

The same basic events occur when 1 then call the method for my second object: 
crit2.talk() 

But this time, the tal k( ) method displays the text Hi. Tm Randol ph since the name attribute 
of crit2 is equal to "Randolph". 

By default, you can access and modify an objecfs attributes outside of its class. In the main 
part of the program, 1 directly accessed the name attribute of cri tl: 
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print(critl.nanie) 

The line prints the string "Poochi e". In general, to access an attribute of an object outside the 
objecfs class, you can use dot notation. Type the variable name, followed by a dot, followed 
by the attribute name. 

UsuaLLy,you want to avoid directLy accessing an objecfs attributas outside of its 
cLass definition. You'LL Learn more aboutthis Later in this chapter, in section "Un- 
derstanding Object EncapsuLation." 



Printing an Object 

Normally, if I were to print an object with the code pri nt(cri tl ), Python would come back 
with something like the cryptic: 

<_main_.Critter object at 0x00A0BA90> 

This telis me that Pve printed a Critter object in the main part of my program, but doesnT 
give me any useful information about the object. However, there is a way to change this. By 

including the special method_ str _() in a class definition, you can create a string repre- 

sentation for your objects that will be displayed whenever one is printed. Whatever string 
you return from the method will be the string that’s printed for the object. 

The_ str _() method I wrote returns a string that includes the value of the objecfs name 

attribute. So, when the following line is executed: 

print(critl) 

this, more useful, text appears: 

Critter object 
name: Poochie 

Even if you never pLan to print an object in your program, creating a_ str_() 

method is stiLL not a bad idea. You may find that being abLe to see the vaLues of 
an objecfs attributes heLps you understand how a program is working (or not 
working). 



UsiNG Class Attributes and Static Methods 

Through attributes, different objects of the same class can each have their own, unique values. 
You could, for example, have 10 different critters running around, each with its own name. 
But you may have some information that relates not to individual objects, but the entire class. 
You might want to, say, keep track of the total number of critters you’ve created. You could 
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give each Cri tter object an attribute called total . But then, whenever a new object is instan- 
tiated, you’d have to update every existing objecfs total attribute. This would be a real pain. 
Fortunately, P 5 d;hon offers a way to create a single value thafs associated with a class itself, 
called a class attribute. If a class is like a blueprint, then a class attribute is like a Post-it note 
stuck to the blueprint. There’s only one copy of it, no matter how many things you make from 
the blueprint. 

You might also find that you want a method thafs associated with the class; for this, Python 
offers the static method. Since static methods are associated with a class, they’re often used to 
Work with class attributes. 

Introducing the Classy Critter Program 

No, the Classy Critter program doesn’t involve a critter that went to finishing school and 
scoffs at other critters who don’t Icnow which fork to use. Instead, the program involves 
attributes and methods that belong to a class rather than a specific object. The program 
defines a class attribute that keeps track of the total number of Cri tter objects instantiated. 
The class also has a static method that displays this number. Figure 8.7 shows the results of 
the program. 


C:\Python31\python.exe HEID 

jficcessing the c]aus attribute Critter.total: M Q 

Creating critters. | 

jH critter has been born? ■■ 

critter has been born? 
p critter has been born? 

The total number of critters is 3 

^l^ccessing the class attribute through an object: 3 
Press the enter kev to exit. 


B 


Figure 8-7 3 

Critters are being 
born Leftand right! 

The program 
keeps track of aLL 
of them through a 
single class 
attribute, which it 
displays through a 
static method. 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 8 folder; the file name is classy_critter.py. 

# C1assy Critter 

# Demonstrates class attributes and static methods 
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class Critter(object): 

.A Virtual pet. 

total = 0 

©staticmethod 
def status(): 

print("\nThe total number of critters is", Critter.total) 

def_init_(self, name): 

printCA critter has been born!") 
self.name = name 
Critter.total += 1 


#mai n 

printCAccessing the class attribute Critter.total, end=" ") 
printCCritter.total) 

print( "\nCreating critters.") 
critl = CritterCcritter 1") 
critZ = CritterCcritter 2") 
crit3 = CritterCcritter 3") 

Critter.statusO 

print( "\nAccessing the class attribute through an object:", end= " ") 
print(critl.total) 

input( "\n\nPress the enter key to exit.") 

Creating a Class Attribute 

The second line in my class definition: 

total = 0 

creates a class attribute total and assigns 0 to it. Any assignment statement like this—a new 
variable assigned a value outside of a method—creates a class attribute. The assignment state¬ 
ment is executed only once, when Python first sees the class definition. This means that the 
class attribute exists even before a single object is created. So, you can use a class attribute 
without any objects of the class in existence. 
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Accessing a CLass Attribute 

Accessing a class attribute is simple. I access the new class attribute in several different places 
in the program. In the main part of the program, I print it with 

print Critter.total 

In the static method status (), I print the value of the Critter class attribute total with 
the line: 


print( "\nThe total number of critters is", Critter.total) 

In the constructor method, I increment the value of this class attribute through the line: 

Critter.total += 1 


As a resuit of this line, every time a new ohject is instantiated, the value of the attribute is 
incremented by 1. 

In general, to access a class attribute, use dot notation. Type the class name, followed by a 
dot, followed by the attribute name. 

Finally, you can access a class attribute through an object of that class. Thafs just what I did 
in the main part of the program with the following line: 

print(critl.total) 

This line prints the value ofthe class attribute total (and not an attribute of the object itself). 
You can read the value of a class attribute through any object that belongs to that class. So, I 
could have used print(crit2.total ) or print(crit3.total ) and gotten the same results in 
this case. 



ALthough you can use an object of a cLass to access a cLass attribute, you can't 
assign a new vaLue to a cLass attribute through an object. If you want to change 
the vaLue of a cLass attribute, access it through its cLass name. 


Creating a Static Method 

The first method in the class is status 0: 
def status(): 

print("VnThe total number of critters is", Critter.total) 

I wrote the definition as part of creating a static method. Notice that the definition doesnT 
have self in its parameter list. Thafs because, like all static methods, ifs designed to be 
invoked through a class and not an object. So, the method won’t be passed a reference to an 
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object and therefore won’t need a parameter, like self, to receive such a reference. Static 
methods can certainly have parameters, but I just didn’t need any for this one. 

While the definition creates a method called status, I put a decorator—something you can 
imagine as decorating or modifying a fnnction or method—right hefore the definition. This 
decorator ultimately creates a static method with the same name: 

©staticmethod 

As a resuit of these three lines of code, the class has a static method, status 0 , which displays 
the total number of Cri tter objects by printing the class attribute total. 

To create your own static method, follow my example. Begin with ©stati cmethod decorator, 
followed hy the class method definition. And since the method is for the entire class, you 
won’t include the sel f parameter, necessary only for object methods. 

Invoking a Static Method 

Invoking a static method is simple. With the first line of the main part of the program, 1 invoke 
the static method: 

Critter.status() 

As you would guess, this displays 0 since no objects have heen instantiated. But notice that 
Fm able to invoke the method without a single ohject in existence. Since static methods are 
invoked through a class, no objects of the class need to exist before you can invoke them. 

Next, 1 create three ohjects. Then, 1 invoke status () again, which prints a message stating that 
three critters exist. This works because, during the execution of the constructor method for 
each object, the class attribute total is increased by 1. 

Understanding Object Encapsulation 

You first learned about the concept of encapsulation with functions in the “Understanding 
Encapsulation” section in Chapter 6. You saw that functions are encapsulated and hide the 
details of their inner workings from the part of your program that calls it (called the client of 
the function). You learned that the client of a well-defined fnnction communicates with the 
function only through its parameters and return values. In general, objects should be treated 
the same way. Clients should communicate with ohjects through method parameters and 
return values. In general, client code should avoid directly altering the value of an objecfs 
attribute. 

As always, a concrete example helps. Say, for example, thatyou had a Checki ng_Account object 
with a bal ance attribute. Let’s say your program needs to handle withdrawals from accounts. 
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where awithdrawal decreases an objecfs bal ance attributeby some amount. To make awith- 
drawal, Client code could simply subtract a number from the value of bal ance. This direct 
access is easy for the client, but can cause problems. The client code may subtract a number 
so that bal ance becomes negative, which might be considered unacceptable (especially by the 
bank). It’s much better to have a method called wi thdraw( ) that allows a client to request a 
withdrawal by passing an amount to the method. Then, the object itself can handle the 
request. If the amount is too large, the object can deal with it, possibly rejecting the transac- 
tion. The object keeps itself safe by providing indirect access to its attributes through 
methods. 

UsiNG Private Attributes and Private Methods 

By default, all of an objecfs attributes and methods are public, meaning that they can be 
directly accessed or invoked by a client. To encourage encapsulation, you can define an 
attribute or method as private, meaning that only other methods of the object itself can easily 
access or invoke them. 

Introducing the Private Critter Program 

The Private Critter program instantiates an object that has both private and public attributes 
and methods. Figure 8.8 shows a sample run. 


C:\Python31\python.exe HEID 

jfi new critte»» }ia;j been born? Q 

,I'm Poochie | 

jRight now 1 feel happy ■■ 

This is a public method. 

This is a private method. 

Press the enter key to exit. 


^ Figure 8.8 ) 

The object's 
private attribute 
and private 
method are 
indirectly 
accessed. 


ITl go through the code one section at a time, but you can find the entire program on the 
companion website (www.courseptr.com/downloads) in the Chapter 8 folder; the file name is 
private_critter.py. 
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Creating Private Attributes 

To limit the direct access of object attributes by clients, you can use private attributes. In the 
constructor method, I create two attributes, one public and one private: 

# Private Critter 

# Demonstrates private variables and methods 

class Critter(object): 

.A Virtual pet. 

def_init_(self, name, mood): 

printCA new critter has been born!") 

self.name = name # public attribute 

self. mood = mood # private attribute 

The two underscore characters that begin the second attribute name teli Python that this is 
a private attribute. To create a private attribute of your own, just begin the attribute name 
with two underscores. 

You can create a private cLass attribute by beginning the attribute's name with 
two underscores. 



Accessing Private Attributes 

It’s perfectly fine to access an objecfs private attribute inside the class definition of the object. 
(Remember, private attributes are meant to discourage client code from directly accessing 
the attribute.) I access a private attribute in the tal k( ) method: 

def talk(self): 

print( "\nrm", self.name) 

printCRight now I feel", self._mood, "\n'') 

This method prints the value of the objecfs private attribute, which represents a critter’s 
mood. 

If I tried to access this attribute outside ofthe Cri tter class definition, Fd have trouble. Here’s 
an interactive session to show you what I mean: 

>» erit = Critter(name = "Poochie", mood = "happy") 

A new critter has been born! 

>» print(crit.mood) 

Traceback (most recent call last): 
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File ''<pyshel 1#1>", line 1, in <niodule> 
print(crit.mood) 

AttributeError: 'Critter' object has no attribute 'mood' 

By raising an AttributeError exception, Python is saying that erit has no attribute mood. If 
you think you can outsmart Python by adding the two leading underscores, you'd be wrong. 
Thafs just what I tried in the next part of my interactive session: 

>>> print(crit._mood) 

Traceback (most recent call last): 

Eile "<pyshel1#2>", line 1, in <module> 
print(crit._mood) 

AttributeError: 'Critter' object has no attribute '_mood' 

This also raises anAttributeError exception. P 5 d;hon is again saying that the attribute doesn’t 
exist. So does this mean that the value of a private attribute is completely inaccessible outside 
of its class definition? Well, no. Python hides the attribute through a special naming con- 
vention, though it’s stili technically possible to access the attribute. Thafs what I did in the 
next part of my interactive session: 

>>> print(crit._Critter_mood) 

happy 

This line prints the value of the elusive private attribute, which in this case is the string 
"happy". 

Since if s technically possible to access private attributes, you may be thinking: What good 
are they? Well, in Python, privacy is an indicator that the attribute or method is meant only 
for an objecfs internal use. In addition, it helps prevent inadvertent access to such an 
attribute or method. 

You shouLd never try to directLy access the private attributes or methods of an 
object from outside of its cLass definition. 



Creating Private Methods 

You can create a private method in the same, simple way you create a private attribute: by 
adding two leading underscores to its name. Thafs just what I do in the next method defini¬ 
tion in the class: 

def _private_method(self): 

printCThis is a private method.") 
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This is a private method but it can easily be accessed by any other method in the class. Like 
private attributes, private methods are meant only to be accessed by an objecfs own methods. 

Accessing Private Methods 

Just as with private attributes, accessing an objecfs private methods within its class defini tion 
is simple. In the pubi i c_method( ) method, I access the class’ private method: 

def public_tnethod(self): 

printCThis is a pubi i c method.") 
self._private_method() 

This method prints the string "This is a pubi i c method ." and then invokes the ohjecf s pri¬ 
vate method. 

Like private attributes, private methods aren’t meant to he directly accessed hy clients. Back 
in my Interactive session, I try to access cri f s private method: 

>» crit.private_method 
Traceback (most recent call last): 

File "<pyshel1#0>", line 1, in <module> 
crit.private_method 

AttributeError: 'Critter' object has no attribute 'private_method' 

This attempt raises the familiar AttributeError exception. Python is saying that erit has no 
method with this name. Python hides the method through the same, special naming con- 
vention. If I try again hy adding the two leading underscores to the method name, I run into 
the same error message: 

>» erit._private_method() 

Traceback (most recent call last): 

Eile "<pyshel1#1>", line 1, in <module> 
erit._private_method() 

AttributeError: 'Critter' object has no attribute '_private_method' 

However, just as with private attributes, it is technically possible to access private methods 
from an 5 where in a program. Here’s the final part of my Interactive session as proof: 

>» erit._Critter_private_method() 

This is a private method. 

But, as you probably know by now, a client should never attempt to directly access an objecfs 
private methods. 
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You can create a private static method by beginning the method’s name with two 
underscores. 


Respecting an Object's Privacy 

In the main part of the program, I behave myself and don’t go prodding into an object’s private 
attributes or methods. Instead, I create an object and invoke its two public methods: 

# main 

erit = Critter(name = "Poochie", mood = "happy") 

crit.talk() 

crit.public_method() 

input("\n\nPress the enter key to exit.") 

The Critter objecfs_ init _ ( ) method, which is automatically called right after the object 

is created, announces to the world that a new critter has been born. crifs tal k( ) method 
telis us how the critter is feeling. cri t’s pubi i c_method() method prints the string "Thi s i s a 
pubi i c method." and then invokes cri t’s private method, which prints the string "Thi s i s a 
private method." Finally, the program ends. 

Understanding When to Implement Privacy 

So now that you Icnow how to use privacy, shouid you make every attribute in every class 
private to protect them from the evil, outside world? Well, no. Privacy is like a fine spice: used 
sparingly, it can greatly improve what you’re making. Make private any method you don’t 
want a Client to invoke. If it’s critical that an attribute never be directly accessed by a client, 
you can make it private. The philosophy among many Python programmers is to trust that 
clients will use an objecfs methods and not directly alter its attributes. 

When you write a cLass: 

* Create methods to reduce the need for cLients to directly access an objecfs 
attributes. 

* Use privacy for those attributes and methods that are compLeteLy internal to 
the operation of objects. 

When you use an object: 

* Minimize the direct reading of an objecfs attributes. 

* Avoid directly altering an objecfs attributes. 

* Never attempt to directly access an objecfs private attributes or methods. 
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CONTROLLING AtTRIBUTE AcCESS 

Sometimes, instead of denying access to an attribute, you may want only to limit access to it. 
For example, you might have an attribute that you want client code to be able to read, but 
not change. Python provides a few tools to accomplish this kind of thing, including proper- 
ties. Properties allow you to manage exactly how an attribute is accessed or changed. 

Introducing the Property Critter 

The Property Critter program allows client code to read a Cri tter objecfs attribute that refers 
to its name, but imposes restrictions when client code attempts to change the value that the 
attribute refers to. If client code tries to assign the empty string, the program complains and 
does not allow the change. Figure 8.9 shows the results of the program. 



A property 
Controls access to 
the Critter 
object's attribute 
for its name. 


B C:\Python31\python.exe 




fi new critter has heen horn? 

Hi, I'm Poochie 

hy critter's name is: Poochie 


fittempting to change my critter's name to Randolph... 
Nane change successful. 

My critter's name is: Randolph 


fittempting to change my critter's name to the empty string. 
fi critter's name can't be the empty string. 

Ny critter's name is: Randolph 


Press the enter key to exit._ 


ril go through the code one section at a time, but you can find the entire program on the 
companion website (www.courseptr.com/downloads) in the Chapter 8 folder; the file name is 
property_critter.py. 

Creating Properties 

One way to control access to a private attribute is to create a property—an ohject with methods 
that allow indirect access to attrihutes and often impose some sort of restriction on that 
access. After the constructor of the Cri tter class, I create a property called name to allow indi¬ 
rect access to the private attribute_ name: 

# Property Critter 

# Demonstrates properties 
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class Critter(object): 

.A Virtual pet. 

def_init_(self, name): 

printCA new critter has been born!") 
self._name = name 

©property 
def name(self): 

return self._name 

I create the property by writing a method that returns the value I want to provide indirect 

access to (in this case,_ name) and precede the method definition with the ©property decorator. 

The property has the same name as the method—in this case, name. Now I can use the name 

property of any Cri tter ohject to get the value of the objecfs private_ name attribute, inside 

or outside the class definition using the familiar dot notation. (Youll see examples of using 
this property in the next section, “Accessing Properties.”) 

To create a property of your own, write a method that returns the value you want to provide 
indirect access to and precede the method definition with the ©property decorator. The prop¬ 
erty will have the same name as the method. lfyou’re providing access to a private attribute, 
the convention is to give the property the same name as the private attribute without the 
leading underscores, just as 1 did here. 

By creating a property, you can provide read access to a private attribute. However, a property 
can also provide write access—and even impose some limits on that access. 1 provide write 
access, with some limits, to the private attribute_ name through the property name: 

©name.setter 

def name(self, new_name): 
if new_name == 

printCA critter's name can't be the empty string.") 
el se: 

self._name = new_name 

printCName change successful.") 

1 begin the code with the decorator ©name.setter. By accessing the setter attribute of the 
name property, Tm saying that the following method definition will provide a way to set the 
value of the property name. You can create your own decorator for setting a property value by 
following my example: start with the © symbol, followed hy the name of the property, followed 
by a dot (.), followed by setter. 
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After the decorator, I detine a method called name that gets called when client code attempts 
to set a new value using the property. You’ll notice that this method is called name just like 
the property; it has to he. When establishing a setter method in this way, the method must 
have the same name as the corresponding property. 

In the method, the parameter new_name gets the value for the new critter name. If the value 

is the empty string,_ name remains unchanged and a message saying that the attempted name 

change was unsuccessful is displayed. Otherwise, the method sets the private attribute 

_name to newjame and displays a message saying the name change was successful. And like 

this example, when you create a method for setting the value of a property, the method 
definition must have a parameter to receive the new value. 

Accessing Properties 

By creating the name property, I can get the name of a critter through dot notation. The next 
part of the program demonstrates this: 

def talk(self): 

print("\nHi, Tm", self.name) 


# main 

erit = CritterCPoochie") 
crit.talk() 

The code sel f .name accesses the name property and indirectly calls the method that returns 

_name. In this case, it happens to return the string "Poochie". But not only can I use the 

name property of anobject inside its class definition, but I can also use it outside the definition 
as I do next: 

print("\nMy critter's name is:", end= " ") 
print(crit.name) 

Although this code is outside the Critter class, the same essential things happen—the code 
cri t. name accesses the name property of the Cri tter object and indirectly calls the method that 
returns_ name. In this case, it stili returns the string " Poochie". 

Next, I try to change the critter’s name: 

print("\nAttempting to change my critter's name to Randolph...") 
erit.name = "Randolph" 

The assignment statement erit, name = "Randolph" accesses the name property of the object 
and indirectly calls the method that attempts to set_ name. In this case, a reference to the 
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string "Randol ph" is passed to the new_name parameter of the method—and since "Randol ph" is 

not the empty string, the objecfs_ name attribute becomes "Randol ph" and the message Name 

change successful is displayed. 

Next, I display the critter’s name using the name property: 

printCMy critter's name is:", end= " ") 
print(crit.name) 

The program displays the message My critter's name is Randol ph. 

Next, I attempt to change the critter’s name to the empty string: 

print( "\nAttempting to change my critter's name to the empty string...") 
erit, name = 

As before, the assignment accesses the name property of the object and indirectly calls 

the method that attempts to set_ name. In this case, a reference to the empty string is passed 

to the new_name parameter of the method. As a resuit, the method displays the message 

A critter's name can't be the empty string and the objecfs _ name attribute remains 

unchanged. 

Finally, to prove that the critter’s name hasn’t been changed to the empty string, I display 
the name one last time: 

printCMy critter's name is:", end= " ") 
print(crit.name) 

input("\n\nPress the enter key to exit.") 

The code displays a message indicating that the critter’s name is stili Randolph. 

Back to THE Critter Caretaker Program 

The final Critter Caretaker program combines parts of classes youVe seen throughout this 
chapter. It also includes the menu system you’ve worked with that allows the user to interact 
with his or her very own critter. TU go through the code one section at a time, but you can 
find the entire program on the companion website (www.courseptr.com/downloads) in the 
Chapter 8 folder; the file name is critter_caretaker.py. 
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The Critter CLass 

The Cn' tter class is the hlueprint for the object that represents the user’s critter. The class 
isn’t complicated, and most of it should look quite familiar, but it’s a long enough piece of 
code that attacking it in pieces makes sense. 

The Constructor Method 

The constructor method of the class initializes the three public attributes of a Cri tter object: 
name, hunger, and boredom. Notice that hunger and boredotn both have default values of 0, allow- 
ing a critter to start off in a very good mood. 

# Critter Caretaker 

# A Virtual pet to care for 

class Critter(object): 

.A Virtual pet. 

def _init_(self, name, hunger = 0, boredom = 0): 

self.name = name 
self.hunger = hunger 
self.boredom = boredom 

I take the more relaxed posture of a Python programmer with this method and leave the 
attributes at their default public status. I plan to provide ali the methods I suspect a client 
will need, which should encourage the client to interact with a Cri tter object only through 
those methods. 

The_pass_time{) Method 

The_ pass_time( ) method is a private method that increases a critter’s hunger and boredom 

levels. It’s invoked at the end of each method where the critter does something (eats, plays, 
or talks) to simulate the passage of time. I made this method private because it should only 
be invoked by another method of the class. I only see time passing for a critter when it does 
something (like eat, play, or talk). 

def _pass_time(self): 

self.hunger += 1 
self.boredom += 1 

The mood Property 

The mood property represents a critter’s mood. The following method calculates the mood. It 
adds the values of a Critter objecfs hunger and boredom attributes and, based on the total, 
returns a string for the mood—either "happy", "okay", "frustrated", or "mad". 
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The interesting thing about the mood property is that it doesn’t provide access to a private 
attribute. Thafs because the string that represents a critter’s mood is not stored as part of 
the Critter object, but is calculated on the fly. The mood property simply provides access to 
the string returned by the method. 

©property 
def mood(self): 

unhappiness = self.hunger + self.boredom 
if unhappiness < 5: 
m = "happy" 

elif 5 <= unhappiness <= 10: 
m = "okay" 

elif 11 <= unhappiness <= 15: 

m = "frustrated" 
el se: 

m = "mad" 
return m 

The talkO Method 

The tal k() method announces a critter’s mood to the world by accessing the Cri tter objecfs 
mood property. Then it invokes_ pass_time(). 

def talk(self): 

printcrm", self.name, "and I feel", self.mood, "now.ln") 
self._pass_time() 

The eat() Method 

The eat() method reduces a critter’s hunger level by an amount passed to the parameter 
food. If no value is passed, food gets the default value of 4. The critter’s hunger level is kept 
in check and not allowed to go below 0. Finally, the method invokes_ pass_time(). 

def eatiself, food = 4): 

print("Brruppp. Thankyou.") 
self.hunger -= food 
if self.hunger < 0: 

self.hunger = 0 
self._pass_time() 
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The pLayO Method 

The pl ay () method reduces the critter’s boredom level by an amount passed to the parameter 
f un. If no value is passed, f un gets the default value of 4. The critter’s boredom level is kept in 
check and not allowed to go below 0. Finally, the method invokes_ pass_tinie(). 

def play(self, fun = 4): 
print("Wheee!") 
self.boredom -= fun 
if self.boredom < 0: 

self.boredom = 0 
self._pass_time() 

Creating the Critter 

I put the main part of the program into its own function, ma i n ( ). At the start of the program, 
I get the name of the critter from the user. Next, I instantiate a new Critter object. Since I 
don’t supply values for hunger or boredom, the attributes start out at 0, and the critter begins 
life happy and content. 

def main(): 

crit_name = inputCWhat do you want to name your critter?: ") 
erit = Critter(crit_name) 

Creating a Menu System 

Next, I created the familiar menu system. If the user enters 0, the program ends. If the user 
enters 1, the objecfs tal k( ) method is invoked. Ifthe user enters 2, the objecfs eat( ) method 
is invoked. If the user enters 3, the objecfs pl ay( ) method is invoked. If the user enters any- 
thing eise, he or she is told the choice is invalid. 

choice = None 
while choice != "0": 
print \ 

^ II II II 

Critter Caretaker 
0 - Quit 

1 - Listen to your critter 

2 - Feed your critter 

3 - Play with your critter 

II II II \ 
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choice = input("Choice: ") 
print() 

# exit 

if choice == "0": 

printCGood-bye.") 

# listen to your critter 
ei if choice == "1": 

cri t.talk() 

# feed your critter 
elif choice == "2": 

crit.eat() 

# play with your critter 
elif choice == "3": 

crit.playO 

# some unknown choice 
el se: 

print("\nSorry, but", choice, "isn't a valid choice.") 

Startingthe Program 

The next line of code calls the tnai n() function and begins the program. The last line waits for 
the User before ending. 

main() 

("\n\nPress the enter key to exit.") 

SUMMARY 

This chapter introduced you to a different way of programming by using the Software object. 
You learned that Software objects can combine functions and data (methods and attributes 
in OOP-speak) and in many ways mimic real-world objects. You saw how to write classes, the 
blueprints of objects. You learned about a special method called the constructor that is auto- 
matically invoked when a new object is instantiated. You saw how to create and initialize 
object attributes through a constructor. You learned how to create class-wide elements such 
as class attributes and static methods. Next, you learned about object encapsulation. You saw 
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ways to help ensure encapsulation, including the use of private attributes and properties. You 
also learned that good object design goes a long way to help ensure encapsulation. Finally, 
you saw all of these ideas put to work to create a demanding Virtual pet that requires constant 
attention. 


* ' 

Challenges 

1. Improve the Critter Caretaker program by allowingthe user to 
specify how much food he or she feeds the critter and how long 
he or she plays with the critter. Have these values affect how 
quickly the critter's hunger and boredom levels drop. 

2. Write a program that simulates a television by creating it as an 
object. The user should be able to enter a channel number and 
raise or lower the volume. Make sure that the channel number 
and volume level stay within valid ranges. 

3. Create a “back door" in the Critter Caretaker program that 

shows the exact values of the object's attributes. Accomplish 
this by printing the object when a secret selection, not listed 
in the menu. is entered as the user's choice. (Hint: add the 
special method_ str _() to the Cri tter class.) 

4. Create a Critter Farm program by instantiating several 
Cr1 tter objectsand keepingtrackof them througha list. Mimic 
the Critter Caretaker program, but instead of requiring the 
user to care for a single critter, require them to care for an 
entire farm. Each menu choice should allow the user to 
perform some action for all of the critters (feed all of the 
critters, play with all of the critters, or listen to all of the 
critters). To make the program interesting, give each critter 
random starting hunger and boredom levels. 




J 


Object-Oriented 
Programming: The 
Blackjack Game 


I n the last chapter, you learned about the Software object. Almost every 
program you saw involved a single object. Thafs a great way to begin to 
understand how objects work, but the true power of OOP can only be 
appreciated by seeing a group of objects work together. In this chapter, you’ll learn 
to create multiple objects and define relationships among them so that they can 
interact. Specifically, you’11 learn to do the following: 

• Create objects of different classes in the same program 
• Allow objects to communicate with each other 
• Create more complex objects by combining simpler ones 
• Derive new classes from existing ones 
• Extend the definition of existing classes 
• Override method definitions of existing classes 

Introducing THE Blackjack Game 

The final project for this chapter is a simplified version of the card game blackjack. 
The game works like this: Players are dealt cards with point values. Each player 
tries to reach a total of 21 without going over. Numbered cards count as their face 
value. An ace counts as either 1 or 11 (whichever is best for the player) and any 
jack, queen, or king counts as 10. 
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The computer is the dealer and competes against one to seven players. At the opening of the 
round, the computer deals all participants (including itself) two cards. Players can see all of 
their cards, and the computer even displays their total. However, one of the dealer’s cards is 
hidden for the time being. 

Next, each player gets a chance to take additional cards. Each player can take one card at a 
time for as long as the player likes. But if the player’s total goes over 21 (known as “busting”), 
the player loses. If all players bust, the computer reveals its first card and the round is over. 
Otherwise, play continues. The computer must take additional cards as long as its total is less 
than 17. If the computer busts, all players who have not themselves busted, win. Otherwise, 
each remaining player’s total is compared with the computer’s. If the player’s total is greater, 
the player wins. If the player’s total is less, the player loses. If the two totals are the same, the 
player ties the computer (also known as “pushing”). Figure 9.1 shows off the game. 


Q Figure9.i ^ 

One player winsj 
the other is not so 
Lucky. 



Sending and Receiving Messages 

In a way, an object-oriented program is like an ecosystem and objects are like organisms. To 
maintain a thriving ecosystem, organisms must interact. The same is true in OOP. To have a 
useful program, objects must interact in well-defined ways. In OOP-speak, objects interact by 
sending messages to each other. What they do on a practical level is invoke each other’s methods. 
That may sound a little impolite, but it’s actually much more courteous than if an obj ect were 
to access another objecfs attributes directly. 
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Introducing the Alien Blaster Program 

The Alien Blaster program simulates an action game where a player blasts an alien. In the 
program, a hero blasts an invader and the invader dies (but not before giving a grand farewell 
speech). The program accomplishes this when one object sends another a message. Figure 9.2 
shows the results of the program. 


C:\Python31\python.exe 


Death of an 
|The playei* blasts an enepiy. 


The alien gasps and says, 'Oh, this is it. This is the big one. 

Ves, it's getting dark now. Teli ny 1.6 nillion laruae that I loved then. 
Good-bye, ci*uel universe.' 


HEID 


Press the enter key to exit. 



The battLe 


descriptiori is the 
resuLt of objects 
exchanging a 
message. 


Technically what happens is that the program instantiates a Player object, hero, and an 
AI i en object, invader. When hero’s bl ast( ) method is invoked with invader as its argument, 
hero invokes i nvader’s di e( ) method. InEnglish, this means that when a player blasts an alien, 
the player sends a message to the alien telling it to die. Figure 9.3 provides a visual represen- 
tation of the message exchange. 



Figure 9-3 3 

hero, a P1 ayer 
obj‘ect, sends 
invader, an 
AI i en object, a 
message. 


hero, blast (invader) 
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In THE Real World 

The diagram I created to show two objects exchanging a message is a pretty simple 
one. But with many objects and many relationships among them, diagrams like this 
can become complex. In fact, there Is a variety of formal methods for mapping Soft¬ 
ware projects. One of the most popular is the UnifiedModeling Language{\iV^\.), a 
notationallanguagethat isespecially usefulforvisualizingobject-oriented Systems. 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 9 folder; the file name is alien_hlaster.py: 

# AI i en B1 aster 

# Demonstrates object interaction 


class P1ayer(object): 

. A player in a shooter game. . 

def blast(self, enemy): 

printCThe player blasts an enemy.\n'') 
enemy.die() 


class AIien(object): 

. An alien in a shooter game. . 

def die(self): 

printCThe alien gasps and says, 'Oh, this is it. This is the big one. \n" \ 
"Yes, it's getting dark now. Teli my 1.6 million larvae that 
cr I loved them... \n" \ 

"Good-bye, cruel universe.'") 


# main 

print( "\t\tDeath of an AlienVn") 

hero = P1ayer() 
i nvader = AI ienO 
hero.blast(invader) 


input( "\n\nPress the enter key to exit.") 
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Sending a Message 

Before you can have one object send another object a message, you need two objects! So, I 
create two in the main part of the program. First, I create a P1 ayer object and assign it to 
hero. Then, I create an AI i en object and assign it to i nvader. 

The next line of code is where it gets interesting. Through hero.blast( i nvader), I invoke 
hero’s bl ast () method and pass i nvader— the AI i en object—as an argument. By examining the 
definition of blastO, you can see that the method accepts the ohject into its parameter 
enemy. So, when bl ast( ) executes, enemy refers to the AI i en object. After displa 5 dng a message, 
blasto invokes the Alien objecfs dieO method through enemy.dieO. Essentially, the 
P1 ayer object is sending the AI i en object a message by invoking its dieO method. 

Receiving a Message 

The AI i en object receives the message from the P1 ayer object in the form of its dieO method 
being invoked. The AI i en ohjecfs dieO method then displays a melodramatic good-bye. 

CoMBiNiNG Objects 

In the real world, interesting ohjects are usually made up of other, independent objects. For 
example, a drag racer can be seen as a single object thafs composed ofindividual objects such 
as a body, tires, and an engine. Other times, you may see an object as a collection of other 
objects. For example, a zoo can be seen as a collection of animals. Well, you can mimic these 
kinds of relationships among objects in OOP. You could write a Drag_Racer class that has an 
attribute engi ne that references a Race_Engi ne object. Or, you could write a Zoo class that has 
an attribute, animals, which is a list of different Animal objects. Combining objects like this 
allows you to create more complex objects from simpler ones. 

Introducing the Playing Cards Program 

The Playing Cards program uses objects to represent individual playing cards that you might 
use in a game of Blackjack or Go Fish (depending upon your tastes ... and your tolerance for 
losing money). The program goes on to represent a hand of cards through an object that is a 
collection of card objects. Figure 9.4 shows the results of the program. 
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Q Figure9.4 ^ 

Each Hand objectis 
a coLLectIon of 
Card objects. 


m C:\Python31\python.exe HEID 

Printing a Card ohject: 

Ac 

Printing the rest of the objects indioidually: 

2c 

3c 

dc 

5c 

Frinting my hand before I add any cards: 

<emptv> 

Printing my hand after adding 5 cards: 

Ac 2c 3c 4c 5c 

Cave the fii*st two cards from my hand to youi* hand. 

Vour hand: 

Ac 2c 
fly hand: 

3c 4c 5c 

hy hand after ciearing it: 

<enpty> 


Press the enter key to exit. Ql 


ril go through the code one section at a time, but you can find the entire program on the 
companion website (www.courseptr.com/downloads) in the Chapter 9 folder; the file name is 
playing_cards .py. 

Creating the Card CLass 

The first thing I do in the program is create a Card class for objects that represent playing 
cards. 

# Playing Cards 

# Demonstrates combining objects 
class Card(object): 


. A playing 

card 

II II II 


RANKS = ["A", 

II2 » 

"3", 

" 4 " "5 " "5" "7" 



"8", 

„9", „j„_ „Q„ 

SUITS = ["c". 

"d". 

"h". 

"s"] 

def _init_(self. 

rank. 

suit): 


self.rank = rank 
self.suit = suit 

def _str_(self): 

rep = self.rank + self.suit 
return rep 
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Each Card object has a rank attribute, which represents the rank of the card. The possible 
values arelisted in the class attribute RANKS. "A" represents an ace, "2" through "10" represent 
their corresponding numeric values, "J" represents a jack, "Q" represents a queen, and "K" 
represents a Idng. 

Each card also has a sui t attribute, which represents the suit of the card. The possible values 
for this attribute are listed in the class attribute SUITS. "c" represents clubs, "d" means dia- 
monds, "h" stands forhearts, and "s" represents spades. So, an object with the rank attribute 
of "A" and a suit attribute of "d" represents the ace of diamonds. 

The special method_ s t r_ () simply returns the concatenation of the rank and suit attributes 

so that an object can be printed. 

Creatingthe Hand Class 

The next thing 1 do in the program is create a Hand class for objects, which is a collection of 
Card objects: 

class Hand(object): 

. A hand of playing cards. . 

def _init_(self): 

self.cards = [] 

def _str_(self): 

if self.cards: 
rep = "" 

for card in self.cards: 
rep += str(card) + " " 

el se: 

rep = "<empty>" 
return rep 

def clear(self): 
self.cards = [] 

def add(self, card): 

self.cards.append(card) 

def give(self, card, other_hand): 
self.cards.remove(card) 
other_hand.add(card) 
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A new Hand object has an attribute cards that is intended to be a list of Card objects. So each 
single Hand object has an attribute that is a list of possibly many other objects. 

The special method_ str _() returns a string that represents the entire hand. The method 

iterates through each Card object in the Hand object and concatenates the Card ohjecfs string 
representation. If the Hand object has no Card objects, the string ''<empty>" is returned. 

The clear( ) method clears the list of cards by assigning an empty list to an objecfs cards 
attribute. 

The add( ) method adds an ohject to the cards attribute. 

The gi ve( ) method removes an object from the Hand object and appends it to another Hand 
object by invoking the other Hand objecfs add( ) method. Another way to say this is that the 
first Hand object sends the second Hand object a message to add a Card object. 


Using Card Objects 

In the main part of the program, I create and print five Card objects: 
# main 

cardl = Card(rank = "A", suit = "c") 
print("Printing a Card object:") 
print(cardl) 


card2 = Card(rank = "2", suit = "c") 

card3 = Card(rank = "3", suit = "c") 

card4 = Card(rank = "4", suit = "c") 

cards = Card(rank = "5", suit = "c") 

print( "\nPrinting the rest of the objects individually:") 

print(card2) 

print(card3) 

print(card4) 

printicardS) 


The first Card object created has a rank attribute equal to "A" and a sui t attribute of "c".When 
I print the object, if s displayed on the screen as Ac. The remaining objects follow the same 
pattern. 
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Combining Card Objects Using a Hand Object 

Next, I create a Hand object, assign it to my_hand, and print it: 
my_hand = Hand() 

print( ''\nPrinting my hand before I add any cards:") 
pri nt(niy_hand) 

Since the objecfs cards attribute is an empty list, printing the object displays the text 
<enipty>. 

Next, I add the five Card objects to my_hand and print it again: 

my_hand.add(cardl) 

my_hand.add(card2) 

my_hand.add(card3) 

my_hand.add(card4) 

my_hand.add(card5) 

print( ''\nPrinting my hand after adding 5 cards:") 
print(my_hand) 

This time, the text Ac 2c 3c 4c 5cis displayed. 

Then, I create another Hand ohject, your_hand. Using my_hand’s give() method, I transfer the 
first two cards from my_hand to your_hand. Then, I print both hands: 

your_hand = Hand() 
my_hand.give(cardl, your_hand) 
my_hand.give(card2, your_hand) 

print('UnGave the first two cards from my hand to your hand.") 

printCYour hand:") 

print(your_hand) 

printCMy hand:") 

print(my_hand) 

As you’d expect, your_hand is displayed as Ac 2c while my_hand appears as 3c 4c 5c. 

Finally, I invoke my_hand’s cl ear() method and print my_hand one last time: 
my_hand.clear() 

print("\nMy hand after clearing it:") 
print(my_hand) 


input(''\n\nPress the enter key to exit.") 
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As it should, the text <empty> is displayed. 


UsiNG Inheritance to Create New Classes 

One of the key elements of OOP is inheritance, which allows you to hase a new class on an 
existing one. By doing so, the new class automatically gets (or inherits) ali of the methods and 
attributes of the existing class—it’s like getting all of the work that went into writing the 
existing class for free! 



In Python, it's possibLe to create a new class that directly inherits from more than 
one class. This is called multiple inheritance. But the approach introduces a 
number of complications. So, as a beginning programmer, it's probably best to 
avoid multiple inheritance. 


Extending a Class through Inheritance 

Inheritance is especially useful when you want to create a more specialized version of an 
existing class. As you just learned, by inheriting from an existing class, a new class gets all of 
the methods and attributes of the existing class. But you can also add methods and attributes 
to the new class to extend what objects of the new class can do. 

For example, imagine that your Drag_Racer class defines a drag racer with methods stop() 
and go( ). You could create a new class for a specialized t 5 ^e of drag racer that can clean its 
windshield (you get a lot of squashed bugs at 250 miles per hour) by basing it on the existing 
Drag_Racer class. Your new class would automatically inherit stopO and goO from 
Drag_Racer. So, allyou’d have to do is define one newmethod for cleaning the windshield and 
the new class would be done. 

Introducing the Playing Cards 2.0 Program 

The Playing Cards 2.0 program is based on the Playing Cards program. The new version intro¬ 
duces the Dec k class to describe a deck of playing cards. However, unlike any other class you’ve 
seen, Deck is based on an existing class, Hand. As a resuit, Deck automatically inherits all of 
Hand’s methods. 1 create Deck this way because a deck of cards is really like a specialized hand 
of cards. lt’s a hand, but with extra behaviors. A deck can do anything that a hand can. lt’s a 
collection of cards. It can give a card to another hand, and so on. On top of that, a deck can 
do a few things that a hand can’t. A deck can be shuffled and it can deal cards to multiple 
hands. The Playing Cards 2.0 program creates a deck that deals cards to two different hands. 
Figure 9.5 illustrates the results of the program. Your results when running the program will 
probably differ from those shown in the figure since the deck is randomly shuffled. 


Chapter9 • Object-Oriented Programming: The Blackjack Game 



m C:\Python31\python.exe 




Created a new 
Deck: 

deck. 



















Populated the 

deck. 









Deck: 











Ac 

2c 

3c 

4c 

5c 

6c 

7c 

8c 

9c 

lOc 


Jc 

Qc 

Kc 

Ad 

2d 

3d 

4d 

5d 

6d 

7d 


8d 

9d 

10d 

Jd 

Qd 

Kd 

Ah 

2h 

3h 

4h 


Sh 

6h 

7h 

8h 

9h 

10h 

Jh 

Qh 

Kh 

As 


2s 

3s 

4s 

5s 

6s 

7s 

8s 

9s 

10S 

Js 



Ks 










Shuffled the deck. 









Deck: 











K.l 

7h 

Js 

Qd 

10S 

Jc 

8c 

2h 

2s 

Kh 


Sc 

7d 

4h 

10h 

10C 

7s 

5s 

6h 

9s 

3h 


Sd 

Jd 

4c 

4d 

9c 

8d 

Ac 

Qs 

Ad 

3s 


.Ih 

Ks 

8s 

6s 

2c 

6c 

6d 

Qc 

4s 

Kc 


Ah 

10d 

7c 

As 

2d 

9h 

3c 

9d 

3d 

5h 


Qh 

8h 










Dealt 

5 cat*ds 

to my 

hand and 

your hand. 






iMg hand: 









K.l 

Js 

10S 

8c 

2s 







Voui* 

fiand: 










Vh 

Qd 

Jc 

2h 

Kh 







Deck: 











Sc 

7d 

4h 

10h 

10C 

7s 

5s 

6h 

9s 

3h 


Sd 

Jd 

4c 

4d 

9c 

8d 

Ac 

Qs 

Ad 

3s 


Jh 

Ks 

8s 

6s 

2c 

6c 

6d 

Qc 

4s 

Kc 


Ah 

10d 

7c 

As 

2d 

9h 

3c 

9d 

3d 

5h 


Qh 

8h 










'Cleai^ed the deck. 









Deck: 

<enpty> 










Press 

the enter key 

to exit. 










The Deck cLass 
Inherits aLL of the 
methods of the 
Hand cLass. 


ril go through the code one section at a time, but you can find the entire program on the 
companion website (www.courseptr.com/downloads) in the Chapter 9 folder; the file name is 
playing_cards2.py. 

Creating a Base CLass 

1 begin the newprogram like the old version. The first two classes, Card and Hand, are the same 
as before: 

# P1aying Cards 2.0 

# Demonstrates inheritance - class extension 
class Card(object): 


. A playing 

card, 

II II II 

RANKS = ["A", 

"2", 

II 2» »4« «^ 

"8", 

"9", 

"10", "J", " 

SUITS = ["c". 

"d", 

"h", "s"] 

def _init_(self, 

rank, suit): 


self.rank = rank 
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self.suit = suit 

def str (self): 

rep = self.rank + self.suit 
return rep 

class Hand(object): 

. A hand of playing cards. 

def _init_(self): 

self.cards = [] 

def str (self): 

if self.cards: 
rep = "" 

for card in self.cards: 
rep += str(card) + "Xt" 

el se: 

rep = ''<enipty>" 
return rep 

def clear(self): 
self.cards = [] 

def add(self, card): 

self.cards.appendicard) 

def give(self, card, other_hand): 
self.cards.remove(card) 
other_hand.add(card) 

Inheriting from a Base Class 

The next thingi do is create the Deck class. You can see from the class header that Deck is based 

on Hand: 

class Deck(Hand): 

Hand is called a base class because Deck is based on it. Deck is considered a derived class because 

it derives part of its definition from Hand. As a resuit of this relationship, Deck inherits all of 
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Hand’s methods. So, evenifldidn’t define a singlenewmethodin this class, Deck objects would 
stili have ali of the methods defined in Hand: 

• _init_0 

• _str_() 

• clearO 

• addO 

• giveO 

If it helps, for this simple example, you can even imagine that youVe copied and pasted ali 
of Hand’s methods right into Deck hecause of inheritance. 

Extending a Derived Class 

You can extend a derived class by defining additional methods in it. Thafs what I do in the 
class definition of Deck: 

. A deck of playing cards. . 

def populate(self): 

for suit in Card.SUITS: 
for rank in Card.RANKS: 

self.add(Card(rank, suit)) 

def shuffle(self): 
import random 
random.shuffleiself.cards) 

def deaUself, hands, per_hand = 1): 
for rounds in range(per_hand): 
for hand in hands: 
if self.cards: 

top_card = self.cardsLO] 
self.give(top_card, hand) 
else: 

print(''Can't continue deal . Out of cards!") 

So, in addition to ali of the methods that Deck inherits, it has the following new methods: 

• populateO 

• shuffleO 

• dealO 
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As far as client code is concerned, any Deck method is as valid as any other—whether it’s 
inherited from Hand or defined in Deck. And all of a Deck objecfs methods are invoked the 
same way, through dot notation. 

Usingthe Derived CLass 

The first thing I do in the main part of the program is instantiate a new Deck object: 

# main 

deckl = Deck() 

Looking at the class, you’ll notice that I don’t define a constructor method in Deck. But Deck 
inherits the Hand constructor, so that method is automatically invoked with the newly created 
Deck object. As a resuit, the new Deck object gets a cards attribute that is initialized to an empty 
list, just as any newly created Hand object would get a similar cards attribute. Finally, the 
assignment statement assigns the new object to deckl. 

Now armed with a new (but empty) deck, 1 print it: 

print("Created a new deck.") 
print("Deck:") 
print(deckl) 

IdidnT define the special_ str _() method in Deck either, butagain, Deck inherits the method 

from Hand. Since the deck is empty, the code displays the text <enipty>. So far, a deck seems 
just like a hand. Thafs because a deck is a specialized type of hand. Remember, a deck can do 
anything a hand can, plus more. 

An empty deck is no fun, so 1 invoke the objecfs popul ate( ) method, which populates the 
deck with the traditional 52 cards: 

deckl.populate() 

Now the deck has finally done something a hand can’t. Thafs because the popul ate () method 
is a new method that 1 define in the Deck class. The popul ate( ) method loops through all of 
the 52 possible combinations ofvalues ofCard.SUITS and Card.RANKS (one for each card in a 
real deck). For each combination, the method creates a new Card object that it adds to the 
deck. 

Next, 1 print the deck: 

print( "\nPopul ated the deck.") 

print("Deck:") 

print(deckl) 
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This time, all 52 cards are displayed! But ifyou look closely, you’ll see that they’re in an obvious 
order. To make things interesting, I shuffle the deck: 

deckl.shuffle() 

I define the shuffleO method in Deck. It imports the random module and then calls the 
random.shuffle( ) function with the objecfs cards attribute. As you might guess, the 
random. shuffl e( ) method shuffles a lisfs elements into a random order. So, all of the elements 
of cards get shuffled. Perfect. 

Now, with the cards in random order, I display the deck again: 

print( ''\nShuffl ed the deck.") 
print("Deck:") 
print(deckl) 

Next, I create two Hand objects and put them in a list that I assign to hands: 

my_hand = Hand() 

your_hand = Hand() 

hands = [my_hand, your_hand] 

Then, I deal each hand five cards: 

deckl.deal(hands, per_hand = 5) 

The deal () method is a new method I de fin e in Deck. It takes two arguments: a list of hands 
and the number of cards to deal each hand. The method gives a card from the deck to each 
hand. If the deck is out of cards, the method prints the message Can' t continue deal. Out of 
cards! The method repeats this process for the numher of cards to be dealt each hand. So, the 
previous line of code deals five cards from deckl to each hand (my_hand and your_hand). 

To see the results of the deal, I print each hand and the deck once more: 

print( ''\nDeal t 5 cards to my hand and your hand.") 

printCMy hand:") 

print(my_hand) 

printCYour hand:") 

print(your_hand) 

print("Deck:") 

print(deckl) 

By looking at the output, you can see that each hand has 5 cards and the deck now has 
only 42. 
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Finally, I put the deck back to its initial state by clearing it: 
deckl.clearO 

print("\nCleared the deck.") 

And then I print the deck one last time: 

print("Deck:", deckl) 

input( "\n\nPress the enter key to exit.") 

Altering THE Behavior of Inherited Methods 

YouVe seen how you can extend a class by adding new methods to a derived class. But you 
can also redefine how an inherited method of a base class works in a derived class. This is 
known as overriding the method. When you override a base class method, you have two choices. 
You can create a method with completely new functionality, or you can incorporate the func- 
tionality of the base class method that you’re overriding. 

Asanexample, takeyour Drag_Racerclassagain.Lefssaythatits stop( ) methodsimplyapplies 
the racer’s brakes. Ifyou want to create a new drag racer class that can stop even more quickly 
(by releasing a parachute behind the racer), you could derive a new Parachute_Racer class 
from Drag_Racer and override its stop( ) method. You could write the new stop( ) method so 
that it invokes the stop( ) method of the original Drag_Racer class (which applies the racer’s 
brakes) and then defines the action of the racer releasing a parachute. 

Introducing the Playing Cards 3.0 Program 

The Playing Cards 3.0 program derives two new classes of playing cards from the Card class 
youVe been working with. The first new class defines cards that can’t be printed. More pre- 
cisely, when you print an object of this class, the text <unpri ntabl e> is displayed. The next 
class defines cards that can be either face up or face down. When you print an object of this 
class, there are two possible results. If the card is face up, it prints out just like an object of 
the Card class. But if the card is face down, the text XX is displayed. Figure 9.6 shows a sample 
run of the program. 
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Q Figure9.6 ^ 

By overriding 
the Inherited 

_str_() 

method, objects 
of different 
derived cLasses are 
printed out 
dIfferentLy. 


ril go through the code one section at a time, but you can find the entire program on the 
companion website (www.courseptr.com/downloads) in the Chapter 9 folder; the file name is 
playing_cards3 .py. 

Creating a Base CLass 

To derive a new class, you need to start with a base class. For this program, 1 use the same 
Ca rd class you’ve come to Icnow and love: 

# P1aying Cards 3.0 

# Demonstrates inheritance - overriding methods 
class Card(object): 


. A playing 

card, 

M II II 


RANKS = ["A", 

"2", 

"3", 

"4", "5 

"8", 

"9", 

"10", 

"J", " 

SUITS = ["c". 

"d", 

"h". 

"s"] 

def _init_(self, 

rank, 

suit): 


self.rank = rank 
self.suit = suit 

def _str_(self): 

rep = self.rank + self.suit 
return rep 







Python Programming for the Absolute Beginner, Third Edition 



Overriding Base CLass Methods 

Next, I derive a new class for unprintable cards based on Card. The class header looks pretty 
Standard: 

class Unprintable_Card(Card): 

From this header, you know that Unpri ntabl e_Card inherits all of the methods of Card. But I 
can change the hehavior of an inherited method hy defining it in a derived class. And thafs 
just what I did in the remainder of the method definition: 

. A Card that won't reveal its rank or suit when printed. . 

def _str_(self): 

return "<unprintable>" 

The Unprintabl e_Card class inherits the_ str_( ) method from Card. But 1 also de fin e a new 

_s t r_( ) method in Unprintabl e_C a r d that overrides (or replaces) the inherited one. Any time 

you create a method in a derived class with the same name as an inherited method, you 
override the inherited method in the new class. So, when you print an Unpri ntabl e_Card 
object, the text <unpri ntabl e> is displayed. 

A derived class has no effect on abase class. A base class doesn’t care ifyou derive a new class 
from it, or if you override an inherited method in the new class. The base class stili functions 
as it always has. This means thatwhenyou print a Card object, it will appear as it always does. 

Invoking Base Class Methods 

Sometimes when you override the method of a base class, you want to incorporate the inher¬ 
ited method’s functionality. For example, 1 want to create a new type of playing card class 
based on Card. 1 want an object of this new class to have an attribute that indicates whether 
or not the card is face up. This means 1 need to override the inherited constructor method 
from Card with a new constructor that creates a face up attribute. However, 1 also want my 
new constructor to create and set rank and suit attributes, just like the Card constructor 
already does. Instead of retyping the code from the Card constructor, 1 could invoke it from 
inside my new constructor. Then, it would take care of creating and initializing rank and 
suit attributes for an object of my new class. Back in the constructor method of my new class, 
1 could add the attribute that indicates whether or not the card is face up. Well, thafs exactly 
the approach 1 take in the Posi tionabl e_Card class: 

class Positionable_Card(Card): 

. A Card that can be face up or face down. . 

def_init_(self, rank, suit, face_up = True): 

super(Positionable_Card, self)._init_(rank, suit) 

self.is_face_up = face_up 
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The new function in the constructor, super (), lets you invoke the method of a base class (also 

called a superdass). The line super(Positionable_Card, self)._init_(rank, suit) invokes 

the_init_() method of Card (the superclass of Positionabl e_Card). The first argument in 

the call to superi), Posi ti onabl e_Card, says that I want to invoke a method of the superclass 
(or base class) of Posi ti onabl e_Card, which is Card. The next argument, sel f, passes a reference 
to the newly instantiated Posi ti onabl e_Card object so that code in the Card can get at the 

object to add the rank and suit attributes to it. The next part of the statement,_ini t_(rank, 

suit), telis Python that 1 want to invoke the constructor method of C a r d and 1 want to pass it 
the values of rank and suit. 

The next method in Positionable_Card also overrides a method inherited from Card and 
invokes the overridden method: 

def _str_(self): 

if self.is_face_up: 

rep = super(Positionable_Card, self)._str_0 

el se: 

rep = "XX" 
return rep 

This_str_() method first checks to see if an objecfs f ace_up attribute is T rue (which means 

that the card is face up). If so, the string representation for the card is set to the string returned 

from Card’s_str_() method called with the Posi ti onabl e_Card object. In other words, if the 

card is face up, the card prints out like any object of the Card class. However, if the card is not 
face up, the string representation returned is "XX". 

The last method in the class doesn’t override an inherited method. It simply extends the 
definition of this new class: 

def flip(self): 

self.is_face_up = not self.is_face_up 

The method flips a card over by toggling the value of an obj ect’s f a c e_u p attribute. If an objecfs 
face_up attribute is True, then invoking the objecfs flipO method sets the attribute to 
False. If an objecfs face_up attribute is False, then invoking the objecfs fl i p() method sets 
the attribute to True. 

Usingthe Derived Classes 

In the main part of the program, 1 create three objects: one from Card, another from 
Unpri ntabl e_Card, and the last from Posi ti onabl e_Card: 
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#mai n 

cardl = CardCA", "c") 

cardZ = Unprintable_Card("A", "d") 

card3 = Positionable_Card("A", "h") 

Next, I print the Card object: 

print("Printing a Card object:") 
print(cardl) 

This Works just like in previous programs, and the text Ac is displayed. 

The next thing I do is print an Unpri ntabl e_Card object: 

print( "\nPrinting an Unprintable_Card object:") 
print(card2) 

Even though the object has a rank attribute set to "A" and a sui t attribute set to "d", printing 
the object displays the text <unprintable> because the Unpri ntabl e_C a rd class overrides its 
inherited _str_() method with one that always returns the string "<unpri ntabl e>''. 

The next two lines print aPositionabl e_C a r d obj ect: 

print( "\nPrinting a Positionable_Card object:") 
print(card3) 

Since the objecfs face_up attribute is True, the objecfs _str_0 method invokes Card’s 

_str_ () method and the text Ah is displayed. 

Next, I invoke the Posi ti onabl e_Card objecfs fl i p() method: 

printCFlipping the Posi ti onabl e_Card object.") 
card3.flip() 

As a resuit, the objecfs face_up attribute is set to False. 

The next two lines print the Positi onabl e_Card object again: 

print("Printing the Positionable_Card object:") 
print(card3) 

input( "\n\nPress the enter key to exit.") 

This time XX is displayed because the objecfs face_up attribute is False. 
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Understanding Polymorphism 

Polymorphism is the quality of being able to treat different t 5 q)es of things the same and have 
those things each react in their own way. Used in the context of OOP, polymorphism means 
that you can send the same message to ohjects of different classes related by inheritance and 
achieve different and appropriate results. For example, Llnprintable_Card is derived from 

Card , and when you invoke the_ str _() method of an Unpri ntabl e_Card object, you get a 

different resuit than when you invoke the_ str _() method of a Card object. The resuit of 

this polymorphic hehavior is that you can print an object even if you don’t know whether it’s 
an Unpri ntabl e_Card or a Card object. Regardless of the class of the ohject, when printed, its 
_str _() method is invoked and the correct string representation of it is displayed. 

Creating Modules 

You first learned about modules in Chapter 3, in the section “Importing the random Module,” 
where you met the random module. But a powerful aspect of Python programming is that you 
can create, use, and even share your own modules. Creating your own modules provides 
important henefits. 

First, by creating your own modules, you can reuse code, which can save you time and effort. 
For example, you could reuse the Card, Hand, and Deck classes you’ve seen so farto create many 
different types of card games without having to reinvent hasic card, deck, and hand func¬ 
tionali ty every time. 

Second, by breaking up a program into logical modules, large programs become easier to 
manage. So far, the programs youVe been working with have been contained in one file. Since 
they’ve been pretty short, this is no big deal. But imagine a program thafs thousands (or even 
tens of thousands) of lines long. Worldng with a program of this size in one, massive file would 
be a real nightmare (professional projects, by the way, can easily get this large). Breaking up 
code into modules also makes it easier for members of a Software engineering team to each 
tackle distinet parts of a project. 

Third, by creating modules, you can share your genius. Ifyou create a useful module, you can 
e-mail it to a friend, who then can use it much like any built-in Python module. 

Introducing the Simple Game Program 

The Simple Game program, as the name suggests, is simple. The program first asks how many 
players want to participate and then proceeds to get each player’s name. Finally, the program 
assigns a random score to each player and displays the results. Not very thrilling, but the 
point of the program is not the game, but rather how the game works. The program uses a 
brand-new module with functions and a class that 1 created. Figure 9.7 displays the results of 
the program. 
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Q Figure9.7 ^ 

SeveraL functions 
and a cLass used in 
the program are 
from a 

programmer- 
created moduLe. 

Writing Modules 

Normally, Fd show you the code for the next program. Simple Game, but in this section, I go 
over the module Fve written that Simple Game uses. 

You create a module the same way you write any other Python program. When you create a 
module, though, you should build a collection of related programming components, such as 
functions and classes, and store them in a single file to be imported into a new program. 

1 created a basic module, called games, that contains two functions and a class that might be 
useful in creating a game. You can find the code on the companion website 
(www.courseptr.com/downloads) in the Chapter 9 folder; the file name is games.py. 

# Games 

# Demonstrates module creation 

class P1ayer(object): 

. A player for a game. . 

def _init_(self, name, score = 0): 

self.name = name 
self.score = score 

def _str_(self): 

rep = self.name + ":\t" + str(self.score) 
return rep 



def ask_yes_no(question): 
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.Ask a yes or no question.. 

response = None 

while response not in ("y", "n"): 

response = input(question).lower() 
return response 

def ask_nuniber(question, low, high): 

.Ask for a number within a range.. 

response = None 

while response not in rangedow, high): 

response = int(input(question)) 
return response 


if _name_== "_main_ 

printCYou ran this module directly (and did not 'import' it).") 
input(''\n\nPress the enter key to exit.") 

This module is named games because I saved the file with the name games. py. Programmer- 
created modules are named (and imported) based on their file names. 

The bulk of the module is straightforward. The Player class defines an object with two 
attributes, name and score, which are set in the constructor method. There’s only one other 
method,_ str _(), which returns a string representation so that objects can be printed. 

YouVe seen the next two functions, ask_yes_no( ) and ask_number( ), before in Chapter 6, in 
the “The ask_yes_no( ) Function” and the “The ask_number( ) Function” sections. 

The next part of the program introduces a new idea, related to modules. The condition of the 

i f statement,_ name_ == "_mai n _", is true if the program is run directly. lt’s false if the 

file is imported as a module. So, if the games. py file is run directly, a message is displayed 
telling the user that the file is meant to be imported and not directly run. 

Importing Modules 

Now that youVe seen the games module, ITl introduce the code of the Simple Game program. 
ITl go through the code one section at a time, but you can find the entire program on the 
companion website (www.courseptr.com/downloads) in the Chapter 9 folder; the file name is 
simple_game.py. 
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# Simple Game 

# Demonstrates importing modules 


import games, random 

You import a programmer-created module the same way you import a built-in module, with 
the import statement. In fact, 1 import the games module along with the familiar random module 
in the same import statement. 



If a programmer-created module isn't in the same directory as the program 
that imports it, Python won't be able to find the module. There are ways around 
this. It's even possible to install a programmer-created module so that it's avail- 
able system-wide, just like built-in modules, butthis requires a special installa- 
tion procedure that's beyond the scope of this book. So for now, make sure that 
any module you want to import is in the same directory as the programs that 
import it. 


Using Imported Functions and Classes 

1 use the imported modules in the remainder of the Simple Game program. After welcoming 
the players and setting up a simple loop, 1 ask how many players there will be in the game: 

print("Welcome to the world's simplest game!\n") 

again = None 
while again != "n": 
players = [] 

num = games.ask_number(question = "How many players? (2 - 5): ", low = 2, high = 5) 

1 get the number of players by calling the ask_number( ) function from the games module. Just 
as with other imported modules, to call a function 1 use dot notation, specifying first the 
module name, followed by the function name. 

Next, for each player, 1 get the player’s name and generate a random score between 1 and 100 
by calling the randrangel ) function from the random module. Then, 1 create a player object 
using this name and score. Since the P1 ayer class is defined in the games module, again 1 use 
dot notation and include the module name before the class name. Then, I append this new 
player object to a list of players. 

for i in range(num): 

name = inputCPlayer name: ") 
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score = random.randrangedOO) + 1 
player = games.Player(name, score) 
players.append(player) 

Next, I print each player in the game: 

print("XnHere are the game results:") 
for player in players: 
print(player) 

Finally, I ask if the players want to play another game. 1 use the ask_yes_no( ) function from 
the games module to ohtain my answer: 

again = games.ask_yes_no("\nDo you want to play again? (y/n): ") 
input("\n\nPress the enter key to exit.") 

Back to THE Blackjack Game 

At this point, you’re an expert in using Python classes to create playing cards, hands, and 
decks. So now it’s time to huild on that expertise and see how to comhine these classes in a 
larger program to create a complete, casino-style card game (tacky green felt not included). 

The cards Module 

To write the Blackjack game, 1 created a final cards module hased on the Playing Cards pro- 
grams. The Hand and Deck classes are exactly the same as those in the Playing Cards 2.0 
program. The new Card class represents the same functionality as the Posi ti onabl e_Card from 
the Playing Cards 3.0 program. You can find the code for the program on the companion 
wehsite (www.courseptr.com/downloads) in the Chapter 9 folder; the file name is cards.py. 

# Cards Module 

# Basic classes for a game with playing cards 

class Card(object): 

. A playing card. . 


RANKS 

= ["A" 

, "2", 

"3", 

"4" "5" "5" "7" 


"8" 

, "9", 

"10", 

"J", "Q". "K"] 

SUITS 

= ["c" 

, "d", 

"h". 

"s"] 

def _ 

.i n i t_ 

(self, 

rank, 

suit, face_up = True) 


self.rank = rank 


272 
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self.suit = suit 

self.is_face_up = face_up 

def _str_(self): 

if self.is_face_up: 

rep = self.rank + self.suit 
el se: 

rep = "XX" 
return rep 

def flip(self): 

self.is_face_up = not self.is_face_up 

class Hand(object): 

. A hand of playing cards. . 

def _init_(self): 

self.cards = [] 

def _str_(self): 

if self.cards: 
rep = "" 

for card in self.cards: 
rep += str(card) + "\t" 

el se: 

rep = "<enipty>" 
return rep 

def clear(self): 
self.cards = [] 

def add(self, card): 

self.cards.append(card) 


def give(self, card, other_hand); 
self.cards.remove(card) 
other_hand.add(card) 
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class Deck(Hand): 

. A deck of playing cards. . 

def populate(self): 

for suit in Card.SUITS: 
for rank in Card.RANKS: 

self.add(Card(rank, suit)) 

def shuffle(self): 
import random 
random.shuffleiself.cards) 

def deaUself, hands, per_hand = 1): 
for rounds in range(per_hand): 
for hand in hands: 
if self.cards: 

top_card = self.cardsLO] 
self.give(top_card, hand) 
el se: 

print(''Can't continue deal . Out of cards!") 


if _name_ == "_main_": 

printCThis is a module with classes for playing cards.") 
input(''\n\nPress the enter key to exit.") 

Designing the Classes 

Before you start coding a project with multiple classes, it can help to map them out on paper. 
You might make a list and include a brief description of each class. Table 9.1 shows my first 
pass at such a listing for the Blackjack game. 

You should try to include all of the classes you think you’11 need, but don’t worry about 
makingyour class descriptions complete, because invariably they won’t be (mine aren’t). But 
making such a list should help you get a good overview of the t 5 rpes of obj ects you’11 be working 
with in your project. 

In addition to describing your classes in words, you might want to draw a family tree of sorts 
to visualize how your classes are related. Thafs what 1 did in Figure 9.8. 
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Table 9. 1 Blackjack Classes ^ 

j 

/- 


-> 

Class 

Base Class 

Descriptiori 

BJ_Card 

cards.Card 

A blackjack playing card. Define an attribute val ue to represent the 
point value of a card. 

BJ_Deck 

cards.Deck 

A blackjack deck. A collection of B J_Ca rd objects. 

BJJand 

cards.Hand 

A blackjack hand. Define an attribute total to represent the point 
total of a hand. Define an attribute nailie to represent the owner of 
the hand. 

BJ_P1ayer 

BJJand 

A blackjack player. 

BJ_Dealer 

BJJand 

A blackjack dealer. 

BJ_Game 

object 

A blackjack game. Define an attribute dec k for a BJ_Deck object. 
Define an attribute deal er for a BJ_Deal er object. Define an 
attribute pl ayers for a list of BJ_P1 ayer objects. 





Q Figure9.8 ^ 

Inheritance 
hierarchy of 
cLasses for the 
BLackjack game. 



A class hierarchy diagram, like the one in Figure 9.8, can give you a summary view of how 
you’re using inheritance. 


Writing Pseudocode for the Game Loop 

The next thing I did in planning the game was write some pseudocode for the play of one 
round. I thought this would help me see how ohjects will interact. Here’s the pseudocode I 
came up with: 

Deal each player and dealer initial 2 cards 
For each player 

While the player asks for a hit and the player is not busted 
Deal the player an additional card 
If there are no players stili playing 
Show the dealer's 2 cards 
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Otherwise 

While the dealer must hit and the dealer is not busted 
Deal the dealer an additional card 
If the dealer is busted 

For each player who is stili playing 
The player wins 
Otherwise 

For each player who is stili playing 

If the player's total is greater than the dealer's total 
The player wins 

Otherwise, if the player's total is less than the dealer's total 
The player loses 
Otherwise 

The player pushes 

Importing the cards and games Modules 

Now that youVe seen the planning, it’s time to check out the code. In the first part of the 
Blackjack program, I import the two modules, cards and games. FU go through the code one 
section at a time, hut you can find the entire program on the companion website 
(www.courseptr.com/downloads) in the Chapter 9 folder; the file name is blackjack.py. 

# Blackjack 

# From 1 to 7 players compete against a dealer 
import cards, games 

I created the games module, you’ll remember, in the Simple Game program, earlier in this 
chapter. 

The BJ_Card CLass 

The BJ_Card class extends the definition of what a card is by inheriting from cards .Card. In 
BJ_Ca rd, I create a new property, val ue, for the point value of a card: 

class BJ_Card(cards.Card): 

. A Blackjack Card. . 

ACE_VALUE = 1 

©property 
def value(self): 
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if self.is_face_up: 

V = BJ_Card.RANKS.index(self.rank) + 1 
if V > 10: 

V = 10 

el se: 

V = None 
return v 

The method returns a number between 1 and 10, which represents the value of a blackjack 
card. The first part ofthe calculation is computed through the expression B J_Ca rd. RANKS. i ndex 
(self.rank) + 1. This expression takes the rank attribute of an object (say "6") and finds its 
corresponding index number in BJ_Card. RANKS through the list method i ndex( ) (for "6" this 
would be 5). Finally, 1 is added to the resuit since the computer starts counting at 0 (this makes 
the value calculated from "6" the correct 6). However, since rank attributes of "J", "Q", and 
"K" resuit in numbers larger than 10, any value greater than 10 is set to 10. If an objecTs 
f ace_up attribute is False, this whole process is sldpped and a value of None is returned. 

The BJ_Deck Class 

The BJ_Deck class is used to create a deck of blackjack cards. The class is almost exactly 
the same as its base class, cards. Deck. The only difference is that 1 override cards. Deck’s 
popul ate() method so that a new BJ_Deck object gets populated with BJ_Card objects: 

class BJ_Deck(cards.Deck): 

. A Blackjack Deck. . 

def populate(self): 

for suit in BJ_Card.SUITS: 
for rank in BJ_Card.RANKS: 

self.cards.appendiBJ_Card(rank, suit)) 

The BJ_Hand Class 

The BJ_Hand class, based on cards.Hand, is used for blackjack hands. 1 override the 
cards .Hand constructor and add a name attribute to represent the name of the hand owner: 

class BJ_Hand(cards.Hand): 

. A Blackjack Hand. . 

def_init_(self, name): 

super(BJ_Hand, self)._init_0 

self.name = name 

Next, 1 override the inherited_ str _() method to display the total point value of the hand: 
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def _str_(self): 

rep = self.name + ":\t" + super(BJ_Hand, self)._str_() 

if self.total: 

rep += "(" + str(self.total) + ")" 
return rep 

Iconcatenatetheobject’snameattributewiththestringreturnedfromthecards.Hand_str_() 

method for the object. Then, if the ohjecfs total property isn’t None, I concatenate the string 
representation of the value of total. Finally, I return that string. 

Next, I create a property called total, which represents the total point value of a hlackjack 
hand. If a hlackjack hand has afacedown card in it, then its total property is None. Otherwise, 
the value is calculated hy adding the point values of all the cards in the hand. 

©property 
def total(self): 

# if a card in the hand has value of None, then total is None 
for card in self.cards: 

if not card.value: 
return None 

# add up card values, treat each Ace as 1 
t = 0 

for card in self.cards: 
t += card.value 

# determine if hand contains an Ace 
contains_ace = False 

for card in self.cards: 

if card.value == BJ_Card.ACE_VALUE: 
contains_ace = True 

# if hand contains Ace and total is low enough, treat Ace as 11 
if contains_ace and t <= 11: 

# add only 10 since we've already added 1 for the Ace 
t += 10 


return t 
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The first part of this method checks to see if any card in the blackjack hand has a val ue 
property equal to None (which would mean that the card is face down). If so, the method 
returns None. The next part of the method simply sums the point values of all the cards in the 
hand. The next part determines if the hand contains an ace. If so, the last part of the method 
determines if the card’s point value shouid be 11 or 1. 

The last method in BJ_Hand is is_busted( ). It returns True if the objecfs total property is 
greater than 21. Otherwise, it returns False. 

def is_busted(self): 

return self.total > 21 

Notice that in this method, I return the resuit of the condition self.total > 21 instead of 
assigning the resuit to a variable and then returning that variable. You can create this Idnd 
of return statement with any condition (any expression actually) and it often results in a more 
elegant method. 

This kind of method, which returns either True or Fal se, is pretty common. It’s often used 
(like here) to represent a condition of an object with two possibilities, such as “on” or “off,” 
for example. This type of method almost always has a name that starts with the word “is,” as 
in is_on(). 

The BJ_Player CLass 

The BJ_P1 ayer class, derived from BJ_Hand, is used for blackjack players: 

class BJ_Player(BJ_Hand): 

. A Blackjack Player. . 

def is_hitting(self): 

response = gaiTies.ask_yes_no("\n" + self.name + ", do you want a hit? (Y/N): ") 
return response == "y" 

def bust(self): 

printlself.name, "busts.") 
self.1ose() 

def lose(self): 

printlself.name, "loses.") 

def win(self): 

print(self.name, "wins.") 
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def push(self): 

print(self.name, "pushes.") 

The first method, i s_hitting( ), returns True if the player wants another hit and returns 
Fa 1 se if the player doesn’t. The bust () method announces that a player busts and invokes the 
objecfs loseO method. The loseO method announces that a player loses. The win( ) method 
announces that a player wins. And the push( ) method announces that a player pushes. The 
busto, loseO, winO, and pushO methods are so simple thatyoumay wonderwhy they exist. 
1 put them in the class because they form a great skeleton structure to handle the more 
complex issues that arise when players are allowed to bet (which they will, when you complete 
one of the chapter challenges at the end of the chapter). 

The BJ_Dealer Class 

The BJ_Deal er class, derived from BJ_Hand, is used for the game’s blackjack dealer: 

class BJ_Dealer(BJ_Hand): 

. A Blackjack Dealer. . 

def is_hitting(self): 

return self.total < 17 

def bust(self): 

printlself.name, "busts.") 

def flip_first_card(self): 
first_card = self.cardsLO] 
first_card.flip() 

The first method, is_hitting(), represents whether or not the dealer is taldng additional 
cards. Since a dealer must hit on any hand totaling 17 or less, the method returns True if the 
objecfs total property is less than 17; otherwise, it returns False. The bustO method 
announces that the dealer busts. The fl i p_fi rst_card() method turns over the dealer’s 
first card. 

The BJ_Game Class 

The BJ_Game class is used to create a single object that represents a blackjack game. The class 
contains the code for the main game loop in its pl ay () method. However, the mechanics of 
the game are complex enough that 1 create a few elements outside the method, including an 

_addi ti onal_cards( ) method that takes care of dealing additional cards to a player and a 

sti 1 l_pl ayi ng property that returns a list of ali players stili pla 5 dng in the round. 
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The_init_{) Method 

The constructor receives a list of names and creates a player for each name. The method also 
creates a dealer and a deck. 

class BJ_Game(object): 

. A Blackjack Game. . 

def_init_(self, names): 

self.players = [] 
for name in names: 

player = BJ_P1ayer(name) 
self.pl ayers.appendiplayer) 

self.dealer = BJ_Dealer("Dealer") 

self.deck = BJ_Deck() 
self.deck.populateO 
self.deck.shufflei) 

The still_playing Property 

The sti 1 l_pl ayi ng property returns a list of all the players that are stili playing (those that 
havenT busted this round): 

©property 

def still_playing(self): 
sp = [] 

for player in self.players: 
if not player.is_busted(): 
sp.append(player) 
return sp 

The_additional_cards{) Method 

The _a dditional_cards() method deals additional cards to either a player or the dealer. The 

method receives an object into its player parameter, which can be either a BJ_Player or 
BJ_Dealer object. The method continues while the objecfs is_busted() method returns 
False and its is_hitting() method returns True. If the objecfs is_busted() method returns 
True, then the objecfs busti) method is invoked. 

def _additional_cardsiself, player): 

while not player.is_bustedi) and player.is_hittingi): 
self.deck.dea 1 i[player]) 
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print(player) 
if player.is_busted(): 
player.bust() 

Polymorphism is at work here in two method calls. The pl ayer. i s_hi tti ng() method call 
Works equally well whether player refers to a BJ_Player object or a BJ_Dealer object. The 

_addi ti onal_cards( ) method never has to know which type of object it’s working with. The 

same is true in the line player.bust(). Since both classes, BJ_Player and BJ_Dealer, each 
defines its own bust() method, the line creates the desired resuit in either case. 

The playO Method 

The pl ay () method is where the game loop is defined and bears a strildng resemblance to the 
pseudocode 1 introduced earlier: 

def play(self): 

# deal initial 2 cards to everyone 

self.deck.deal(self.players + [self.dealer], per_hand = 2) 
self.dealer.flip_first_card() # hide dealer's first card 

for player in self.players: 

print(player) 
printiself.dealer) 

# deal additional cards to players 
for player in self.players: 

self._additional_cards(player) 

self.dealer.flip_first_card() # reveal dealer's first 
if not self.still_playing: 

# since all players have busted, just show the dealer's hand 
print(self.dealer) 

el se: 

# deal additional cards to dealer 
print(self.dealer) 

self._additional_cards(self.dealer) 

if self.dealer.is_busted(): 

# everyone stili playing wins 
for player in self.sti1l_playing: 
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player.winO 

else: 

# compare each player stili playing to dealer 
for player in self.still_playing: 

if player.total > self.dealer.total: 
player.winO 

elif player.total < self.dealer.total: 

pl ayer .1 ose() 
el se: 

player.push() 

# remove everyone's cards 
for player in self.players: 

player.clearO 
self.dealer.clear() 

Each player and dealer is dealt the initial two cards. The dealer’s first card is flipped to hide 
its value. Next, all of the hands are displayed. Then, each player is given cards as long as the 
player requests additional cards and hasn’t husted. If all players have busted, the dealer’s first 
card is flipped and the dealer’s hand is printed. Otherwise, play continues. The dealer gets 
cards as long as the dealer’s hand total is less than 17. If the dealer busts, all remaining players 
win. Otherwise, each remaining player’s hand is compared with the dealer’s. If the player’s 
total is greater than the dealer’s, the player wins. If the player’s total is less, the player loses. 
If the two totals are equal, the player pushes. 

The mainO Function 

The main( ) function gets the names of all the players, puts them in a list, and creates a 
BJ_Game object, using the list as an argument. Next, the function invokes the objecfs pl ay() 
method and will continue to do so until the players no longer want to play. 

def main(): 

print( "\t\tWel come to B1ackjack!\n") 
names = [] 

number = games.ask_number("How many players? (1 - 7): ", low = 1, high = 8) 
for i in range(number): 

name = inputCEnter player name: ") 
names.append(name) 
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print() 

game = BJ_Game(names) 

again = None 
while again != "n": 
game.playO 

again = games.ask_yes_no("\nDo you want to play again?: ") 


main() 

input(''\n\nPress the enter key to exit.") 

SUMMARY 

This chapter introduced you to the world of OOP. You saw how to send messages between 
obj ects. You learned how to combine obj ects together to form more complex objects. You were 
introduced to inheritance, the process of creating new classes based on existing ones. You 
saw how to extend a derived class by adding new methods. You also saw how to override 
inherited methods. You learned how to write and import your own modules. You were shown 
an example of how to sketch out your classes before you begin a project. And finally, you saw 
all of these concepts come together in the creation of a multiplayer, casino-style card game. 


f ^ 

Challenges 

1. Add some much-needed error checkingto the Blackjack game. 
Before a new round begins. makesurethatthedeckhasenough 
cards. If not, repopulate and reshuffle it. Find other places 
where you could add error checking and create the necessary 
safeguards. 

2. Write a one-card version of the game war, where each player 
gets a single card and the player with the highest card wins. 

3. Improve the Blackjack project by allowing players to bet. Keep 
trackof each playei^s bankrolland remove any player whoruns 
out of money. 

4. Create a simple adventure game using objects, where a player 
can travel between various, connected locations. 
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GUI Development: The 
Mad Lib Program 


S o far, all the programs you’ve seen have used plain old text to interact with 
the User. But there are more sophisticated ways to present and accept 
Information. A graphical user interface (GUI) provides a visual way for a 
User to interact with the computer. The most popular horne operating systems all 
employ a GUI, making user interactions simpler and more consistent. In this chap- 
ter, you’11 learn to create GUIs. Specifically, you’11 learn to do the following: 

• Work with a GUI toolkit 
• Create and fili frames 
• Create and use buttons 
• Create and use text entries and text boxes 
• Create and use check buttons 
• Create and use radio buttons 

Introducing THE Mad Lib Program 

The chapter project, the Mad Lib program, asks for the user’s help in creating a 
story. The user supplies the name of a person, a plural noun, and a verb. The user 
can also choose from several adjectives and may select one body part. The program 
takes all of this information and uses it to create a story. Figures 10.1 through 10.3 
Show off the program. As you can see, the Mad Lib program uses a GUI to interact 
with the user. 
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Mad Lib 




Enter information for a new story 

Person: 

Plural Noun: 

Verb: 



Adjective(s); 

P itchy 

r joyous 

(” electric 

Body Parti 

Click for story | 

C bellybutton 

P big toe 

P medulla oblongata 


Q Figure io.i ^ 

A niceLy Laid-out 
GUI awaits the 
user's creativity. 


Mad Lib 


Q Figure io.z ^ 

The User has 
entered aLL of the 
necessary 
Information. 


Mad Lib Q®® 


Q Figure 10.3 ^ 

After cLicking the 
CLick for story 
button, the text 
box dispLays the 
Literary 
masterpiece. 


Enter information for a new story 



Person: 

Keren 



Plural Noun: 

saiamanders 



Verb: 

Idance 



Adjective(s)i 

itchy 

F joyous 

R electric 

Body Parti 

^ bellybutton 

(* big toe 

P medulla oblongata 

Click for story j 





The famous explorer Keren had nearly given up a life-long quest to find 
The Lost City of Saiamanders when one day, the salamanders found Keren. A 
strong, itchy, electric, pecuiiar feeling overwheltned the explorer. After 
ali this time, the quest uas finally over. A tear came to Keren's big toe. 
And then, the saiamanders promptly devoured Keren. The moral of the story? 
Be careful uhat you dance for. 


Enter information for a new story 



Person: 

Keren 



Plural Noun: 

saiamanders 



Verb: 

Idance 



Adjective(s)i 

itchy 

P joyous 

R electric 

Body Parti 

^ bellybutton 

(* big toe 

P medulla oblongata 

Click for story 
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Examining a GUI 

Before I describe how to program a GUI, I want to define all of the GUI elements you’II meet 
in this chapter. Figure 10.4 shows ofF the Mad Lib program, though this time the various 
elements are laheled. 



Frame 


Button Label 


Text entry 


Check button 


Radio 

button 


■Text box 


^ Figure 10.4 ) 

You'LL Leam to 
create aLL of these 
GUI elements. 


To create a GUI with Python, you need to use a GUI toolkit. There are many to pick from, but 
I use Tkinter, a popular cross-platform toolkit, in this chapter. 

If you're running an operating system other than Windows, you may need to 
downLoad and instaLL additionaL Software to use the Tkinter toolkit. To find out 
more, visit the Python website's Tkinter page at http://www.python.org/topics/ 
tkinter. 



You create GUI elements by instantiating objects from classes of the tki nter module, which 
is part of the Tkinter toolkit. Table 10.1 describes each GUI element from Figure 10.4 and lists 
its corresponding tki nter class. 

There's no need to memorize all of these tkinter classes. I just want to giveyou 
an OverView of the classes thatyou learn about in this chapter. 
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Table i 0. 

1 Selected GUI Elements ^ 

f - 


-> 

Element 

tkinter 

Class Descriptiori 

Frame 

Frame 

HoLds other GUI elements 

LabeL 

Label 

Displays uneditable text or icons 

Button 

Button 

Performs an action when the user activates it 

Text entry 

Entry 

Accepts and displays one line of text 

Text box 

Text 

Accepts and displays multiple lines of text 

Check button 

Checkbutton 

Allows the user to select or not select an option 

Radio button 

Radiobutton 

Allows, as a group, the user to select one option from several 





Understanding Event-Driven Programming 

GUI programs are traditionally event-driven, meaning they respond to actions regardless of the 
order in which they occur. Event-driven programming is a somewhat different way of think- 
ing about coding. But don’t worry, because if youVe ever used a GUI before (like a web 
browser), then youVe already worked within an event-driven system. 

To better understand the event-driven way, think about the Mad Lib final project from this 
chapter. If you were to write a similar program with your current Python skills, you’d probably 
ask the user a series of questions with the i nput () function. You might ask for the name of a 
person, followed by a plural noun, followed by a verb, and so on. As a resuit, the user wouid 
have to provide each piece of information, in order. But, if you were to write the program in 
an event-driven way, say with a GUI, the user couid enter the information in any order. Also, 
the timing of when the program actually generates the story wouid be up to the user as well. 

When you write an event-driven program, you bind (associate) events (things that can happen 
involving the program’s objects) with event handlers (code that runs when the events occur). 
As a concrete example, think about the Mad Lib chapter project again. When the user clicks 
the Glick for story button (the event), the program invokes a method that displays the story 
(the event handier). In order for this to happen, I have to associate the button click with the 
story-telling method (I bind the two with each other). 

By defining all of your objects, events, and event handlers, you establish how your program 
Works. Then, you Idck off the program by entering an event loop, where the program waits for 
the events that you’ve described to occur. When any of those events do occur, the program 
handies them, just as you’ve laid out. 
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Don’t worry if this somewhat different way of thinldng about programming isn’t completely 
ciear yet. After seeing a few working examples, you’11 understand how to devise event-driven 
programs of your own. 

USING A RoOT WiNDOW 

The foundation of your GUI program is its root window, upon which you add ali other GUI 
elements. If you think of your GUI as a tree, then the root window is, well, the root. Your tree 
can branch out in all directions, but every part of it is, directly or indirectly, anchored by 
the root. 


Introducing the Simple GUI Program 

The Simple GUI program creates about the simplest GUI possible: a single window. 
Figure 10.5 shows the results of the program. 



Q Figure io-S ^ 

The program 
createsonLya Lone 
window. Hey, you 
have to start 
somewhere. 



Running a Tkinter program directly from IDLE wiLL cause either your program or 
IDLE to Lock up. The simplest solution is to run your Tkinter program directly. In 
Windows, you can do this simply by double-clicking your program's icon. 



Although you can run a Tkinter program by double-clicking its icon, youTl have 
a problem if the program contains an error—your console window will close be- 
fore you can read the error message. Under Windows, you can create a batch file 
that runs your program and pauses once the program ends, keeping the console 
window open so you can see any error messages. For example, if your program 
is simple_gui.py, just create a batch file comprised of the two lines: 


simple_gui.py 
pause 


Then run the batch file by double-clicking its icon. 
To create a batch file: 
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1. Open a text editor Like Notepad (not Word or WordPad) 

2. Typeyourtext 

3. Save the file with a .bat extensiori (such as simpLe_gui.bat) and make sure 
there is no .txt extension after the .bat 

IVe created batch files for alL of the programs in this chapter. You can find them 
on the companion website (www.courseptr.com/downLoads) in the Chapter I 0 
foLder, aLong with the chapter programs. 


In addition to the window pictured in Figure 10.5, Simple GUI may generate another window 
(depending upon your operating system): the familiar console window, pictured in 
Figure 10.6. 


Q Figure io.6 ^ 

A GUI program 
can generate a 
consoLe window 
too. 



Although you may think that this console window is just an eyesore, marring your otherwise 
perfect GUI, don’t be so quick to dismiss it. The console window can provide valuable feedback 
if (and when) your Tkinter program produces errors. Also, don’t close the console window, 
because that will close your GUI program along with it. 

Once you get your GUI programming running perfectLy, you may want to sup- 
press its accompanying consoLe window. On a Windows machine, the easiest way 
to do this is to change the extension of your program f rom py to pyw. 

You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Ghapter 10 folder; the file name is simple_gui.py. 
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Importing the tkinter Module 

Finally, it’s time to get your hands dirty with some code! The first thing I do in the Simple 
GUI program is import the tki nter module: 

# Simple GUI 

# Demonstrates creating a window 


from tkinter import * 

The previous code imports all of tki nter directly into the program’s global scope. Normally, 
you want to avoid doing something like this; however, a few modules, like tkinter, are 
designed to be imported in this way. You’ll see just how this helps in the next line of code. 


Creating a Root Window 

To create a root window, I instantiate an object of the tkinter class Tk: 

# create the root window 
root = Tk() 


Notice, though, that I didnT have to prefix the module name, tki nter, to the class name, Tk. 
In fact, I can now directly access any part of the tkinter module, without having to use the 
module name. Since most tki nter programs involve many references to classes and constants 
in the module, this saves a lot of typing and makes code easier to read. 



You can have onLy one root window in a Tkinter program. If you create more than 
one, youYe bound to freeze up your program as both root Windows fight for 
controL. 


Modifying a Root Window 

Next, I modify the root window using a few of its methods: 

# modify the window 
root.titleCSimple GUI") 
root.geometryi"200x100") 

The ti tl e () method sets the title of the root window. All you have to do is pass the title you 
want displayed as a string. I set the title so that the text Simpl e GUI appears in the window’s 
title bar. 
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The geometry () method sets the size of the root window, in pixels. The method takes a string 
(and not integers) that represents the window’s width and height, separated by the "x" char¬ 
acter. I set the window’s width to 200 and its height to 100. 

Entering a Root Wmdow's Event Loop 

Finally, I start up the window’s event loop by invoking roofs mai nl oop( ) method: 

# kick off the window's event loop 
root.mainloop() 

As a resuit, the window stays open, waiting to handle events. Since 1 havenT defined any 
events, the window doesnT do much. But it is a fnll-fledged window that you can resize, 
minimize, and close. Feel free to give it a test drive by double-clicking the batch file’s icon. 

USING LaBELS 

GUI elements are called widgets (short for “window gadgets”). Probably the simplest widget is 
the Label widget, which is uneditable text or icons (or both). A Label widget labeis part of a 
GUI. lt’s often used to label other widgets. Unlike most other widgets, labeis aren’t Interactive. 
A User can’t click on a label (alright, a user can, but the label won’t do an 5 Thing). Stili, labeis 
are important and you’11 probably use at least one every time you create a GUI. 

Introducing the Labeler Program 

The Labeler program creates a root window and adds a label to it. The Label widget simply 
declares that it is a label. Figure 10.7 illustrates the program. 


Q Figure 10.7 ^ 

A LabeL can 
provide 

information about 
a GUI. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Ghapter 10 folder; the file name is labeler.py. 

Setting Up the Program 

First, 1 set up the Labeler program by importing tki nter and creating a root window: 

# Labeler 

# Demonstrates a label 
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from tkinter import * 

# create the root window 
root = Tk() 
root.titleCLabeler") 
root.geotiietry( "200x50") 

Creating a Frame 

A Frame is a widget that can hold other widgets (such as Label widgets). A frame is like the 
Cork in a corkboard; you use it as a base on which to place other things. So, I create a new 
frame: 

# create a frame in the window to hold other widgets 
app = Frame(root) 

Any time you create a new widget, you must pass its master (the thing that will contain the 
widget) to the constructor of the new object. Here, I pass root to the Frame constructor. As a 
resuit, the new frame is placed inside the root window. 

Next, 1 invoke the gri d( ) method of the new object: 

app.grid() 

g ri d ( ) is a method that all widgets have. lt’s associated with a layout manager, which lets you 
arrange widgets. To keep things simple, 1 save the discussion of layout managers for a bit later 
in this chapter. 

Creating a Label 

1 create a Label widget by instantiating an object of the Label class: 

# create a label in the frame 

Ibl = LabeUapp, text = "Tm a label!") 

By passing app to the Label objecfs constructor, 1 make the frame that app refers to the master 
of the Label widget. As a resuit, the label is placed in the frame. 

Widgets have options that you can set. Many of these options affect how the widget appears. 
By passing the string " I' m a 1 abel I" to the text parameter, 1 set the widgefs text option to 
that string. As a resuit, the text I' m a 1 abel 1 appears when the label is displayed. 

Next, 1 invoke the objecfs grid() method: 

Ibl.grid() 
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This ensures that the label will be visible. 

Entering the Root Wmdow's Event Loop 

Last, but not least, I invoke the root window’s event loop to start up the GUI: 

# kick off the window's event loop 
root.mainloop() 

USING BuTTONS 

A Button widget can be activated by the user to perform some action. Since you already know 
how to create labeis, learning how to create buttons will be pretty easy. 

Introducing the Lazy Buttons Program 

In the Lazy Buttons program, I create several buttons that don’t do an 5 bhing when activated. 
This is sort of like installing a new light fixture before wiring it. The fixture is put into place, 
but not yet fnnctional. Figure 10.8 illustrates the program. 


Q Figure 10.8 ^ 

You can cLIckthese 
Lazy buttons aLL 
you want; they 
won't do a thing. 



You can find the code for the program on the companion website (www.courseptr.com/dovm- 
loads) in the Chapter 10 folder; the file name is lazy_buttons.py. 

Setting Up the Program 

First, I set up the program by importing tki nter and creating a root window and a frame: 

# Lazy Buttons 

# Demonstrates creating buttons 
from tkinter import * 

# create a root window 
root = Tk() 

root.titleCLazy Buttons") 
root.geometryi"200x85") 











Chapter 10 • GUI Development: The Mad Lib Program 



# create a frame in the window to hold other widgets 
app = Frame(root) 

app.grid() 

Creating Buttons 

You create a Button widget by instantiating an object of the Button class. Thafs what I did in 
the next lines: 

# create a button in the frame 

bttnl = Button(app, text = "I do nothing!") 
bttnl.grid() 

These lines create anewbutton with the text I do nothing! The button’s master is the frame 
1 created earlier, which means that the button is placed in the frame. 

The tki nter module offers flexibility when it comes to creating, defining, and altering wid¬ 
gets. You can create a widget and set all of its options in one line (like Tve been doing), or you 
can create a widget and set or alter its options later. Tll show you what 1 mean with the next 
button. First, 1 create a new button: 

# create a second button in the frame 
bttn2 = Button(app) 

bttn2.grid() 

Notice though that the only value 1 pass to the objecfs constructor is app, the button’s master. 
So, all Fve done is add a blank button to the frame. However, 1 can fix that. 1 can modify a 
widget after 1 create it, using the objecfs confi gure( ) method: 

bttn2.configure(text = "Me tooi") 

This line sets the text option of the button to the string "Me tooi ", which puts the text Me 
too 1 on the button. 

You can use a widgefs conf i gure( ) method for any widget option (and any type of widget). 
You can even use the method to change an option that you’ve already set. 

Next, 1 create a third button: 

# create a third button in the frame 
bttnB = Button(app) 

bttn3.grid() 

Then, 1 set the button’s text option, using a different interface: 
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bttn3["text"] = "Same here!" 

I access the button’s text option through a dictionary-like interface. I set the text option to 
the string "Same here! ",whichputs the text Same here! on the button. When you set the value 
of an option using this type of dictionary-style access, the key for the option is the name of 
the option as a string. 

Entering the Root Wmdow's Event Loop 

As always, I invoke the root window’s event loop to start up the GUI: 

# kick off the window's event loop 
root.mainloop() 

Creating a GUI Using a Class 

As youVe learned in other chapters, organizing your code into classes can make your pro¬ 
gramming life a lot easier. It’s often beneficiai to write larger GUI programs by defining your 
own classes. So next, I show you how to write a GUI program by organizing the code with a 
class. 


Introducing the Lazy Buttons 2 Program 

The Lazy Buttons 2 program is simply the Lazy Buttons program rewritten using a class. The 
program appears exactly the same to the user, but behind the scenes Tve done some restruc- 
turing. Figure 10.9 shows the ever-so-familiar program in action. 


Q Figure 10.9 ^ 

lt’s deja vu aLL over 
again. The program 
Looks the same as 
its predecessor 
even though there 
are significant 
changes underthe 
hood. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 10 folder; the file name is lazy_buttons2.py. 


Importing the tkinter Module 

Though there are significant structural changes to the program, importing the GUI module 
is stili the same: 
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# Lazy Buttons 2 

# Demonstrates using a class with tkinter 
frotn tkinter import * 

Defining the Application Class 

Next, I create a new class, Appi i cati on, based on Frame: 

class Appiication(Frame): 

. A GUI application with three buttons. . 

Instead of instantiating a Frame object, Tll end up instantiating an Appi i cati on object to hold 
all of the buttons. This works since an Appi i cati on object is just a specialized type of Frame 
object. 

Defining a Constructor Method 

Next, I define Appi i cati on’s constructor: 

def_init_(self, master): 

. Initialize the Frame. . 

super(Appi i cation, self)._init_(master) 

self.gridO 

self.create_widgets() 

The first thing I do is call the superclass constructor. I pass along the Application objecfs 
master, so it gets properly set as the master. Finally, I invoke the Application objecfs 
create_widgets() method, which I define next. 

Defining a Method to Create the Widgets 

I define a method that creates all three buttons, create_wi dgets (): 

def create_widgets(self): 

. Create three buttons that do nothing. . 

# create first button 

self.bttnl = Button(self, text = "I do nothing! ") 
self.bttnl.gridO 

# create second button 
self.bttn2 = Button(self) 
self.bttn2.grid() 
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self.bttn2.configure(text = "Me too!") 

# create third button 
self.bttn3 = Button(self) 
self.bttnS.gridO 

self.bttn3["text''] = "Same here! " 

The code looks pretty similar to the code that creates the buttons in the original Lazy Buttons 
program. An important difference is that bttnl, bttnZ, and bttn3 are attributes of an 
Appi i cati on object. Another important difference is that I use sel f as the master for the but¬ 
tons so that the Appi i cati on object is their master. 

Creating the Application Object 

In the main section of code, I create a root window and give it a title and a proper size: 

# main 
root = Tk() 

root.titleCLazy Buttons 2") 
root.geometryl"200x85") 

Then, I instantiate an Appi i cati on object with the root window as its master: 
app = Application(root) 

This code creates an Appi i cati on object with the root window as its master. The Appi i cati on 
objecfs constructor invokes the objecTs create_wi dgets () method. This method then creates 
the three buttons, with the Appi i cati on object as their master. 

Finally, I invoke the root window’s event loop to kick off the GUI and keep it running: 
root.mainloop() 

Binding Widgets and Event Handlers 

So far, the GUI programs youVe seen don’t do a whole lot. Thafs because there’s no code 
associated with the activation of their widgets. Again, these widgets are like light fixtures 
that have been installed, but not connected to electrical wiring. Well, now it’s time to get the 
electricity flowing; or in the case of GUI programming, it’s time to write event handlers and 
bind them with events. 
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Introducing the Click Counter Program 

The Click Counter program has a button that does something: it displays the number of times 
the User has clicked it. Technically, the button’s event handler takes care of updating the click 
count and changing the text on the button. Figure 10.10 shows off the program. 



^ Figure 10.10 ) 

The button's 
event handLer 
updates the 
number of times 
the button is 
cLicked. 


You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 10 folder; the file name is click_counter.py. 

Setting Up the Program 

As my traditional first step, 1 import the GUI module: 

# C1ick Counter 

# Demonstrates binding an event with an event handler 
from tkinter import * 

Next, 1 start the Appi i cati on class definition: 
class Appiication(Frame): 

. GUI application which counts button clicks. . 

def_init_(self, master): 

. Initialize the frame. . 

super(Appi i cation, self)._init_(master) 

self.grid() 

self.bttn_clicks =0 # the number of button clicks 

self.create_widget() 

YouVe seen most of this code before. The new line is self. bttn_cl i cks = 0, which creates an 
ob j ect attribute to keep track of the number of times the user clicks the button. 

Binding the Event Handler 

In the create_wi dget( ) method, 1 create a single button: 
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def create_widget(self): 

. Create button which displays number of clicks. . 

self.bttn = Button(self) 
self.bttn["text"]= "Total Clicks: 0" 
self.bttn[''conimand"] = self .update_count 
self.bttn.gridO 

I set the Button widgefs command option to the update_count( ) method. As a resuit, when the 
User clicks the button, the method is invoked. Technically, what Fve done is bind an event 
(the clicldng of Button widget) to an event handler (the update_count() method). 

In general, you set a widgefs command option to bind the activation of the widget with an event 
handler. 

Creating the Event Handler 

Next, 1 write the update_count () method, which handles the event of the button being clicked: 
def update_count(self): 

. Increase click count and display new total. . 

self.bttn_clicks += 1 

self.bttn["text"] = "Total Clicks: " + str(self.bttn_clicks) 

This method increments the total number of button clicks and then changes the text of the 
button to reflect the new total. Thaf s all it takes to get a button to do something useful (or 
almost useful). 

Wrapping Up the Program 

The main part of the code should be pretty familiar to you by now: 

# main 
root = Tk() 

root.titleCClick Counter") 
root.geometry("200x50") 

app = Appiication(root) 

root.mainloop() 

1 create a root window and set its title and dimensions. Then 1 instantiate a new Appi i ca¬ 
ti on object with the root window as its master. Lastly, 1 start up the root window’s event loop 
to bring the GUI to life on the screen. 
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USING TEXT AND EnTRY WiDGETS AND THE GrID LaYOUT MaNAGER 

In GUI programming, there will be times where youll want a user to enter some text. Other 
times, you may want to display text to the user. For both of these occasions, you can use text- 
based widgets. I introduce you to two kinds. The Entry widget is good for one line of text, 
while the T ext widget is great for multiline blocks of text. You can read the contents of either 
of these widget types to get user input. You can also insert text into them to provide the user 
with feedback. 

Once you start throwing a hunch of widgets into a frame, you need a way to organize them. 
So far, Tve used the Gri d layout manager, but in oniy the most limited way. The Gri d layout 
manager offers you a lot more controi over the way your GUI looks. The manager lets you 
place widgets at specific locations by treating a frame as a grid. 

Introducing the Longevity Program 

The Longevity program reveais the secret to living to the ripe old age of 100, if the user enters 
the secret password (the highly secure “secret”). The user enters the password in the text entry 
and then clicks the Submit button. If the password is correct, the program displays the key 
to longevity in the text box. Figures 10.11 and 10.12 show off the program. 


^ Figure io.ii ) 

If the userfalLs to 
enter the correct 
password, the 
program poLItely 
refuses to divuLge 
Its secret. 


Longevity 


^ Figure io.I2 ) 

Glven the correct 
password, the 
program shares its 
invaLuabLe 
knowLedge to Long 
Life. 


Enter password for the secret of longevity 
Password: secret | 

Submit I 

Here'3 the secret to living to 
100: live to 99 and then be VERY 
careful. 


Longevity QIhJ® 


Enter password for the secret of longevity 
Password: teli me! 

Submit I 

That's not the correct password, 
so I can't share the secret with 
you. 
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You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 10 folder; the file name is longevity.py. 

Setting Up the Program 

I set up the program just like the last few: 

# Longevity 

# Demonstrates text and entry widgets, and the Grid layout manager 
from tkinter import * 

class Application(FraiTie): 

. GUI application which can reveal the secret of longevity. . 

def_init_(self, master): 

. Initialize the frame. . 

super(Appiication, self)._init_(master) 

self.gridO 

self.create_widgets() 

I import the tkinter module and start to define the Application class. In the constructor 
method, 1 initialize the new Appi i cati on object, make sure it will be visible, and invoke the 
objecfs create_widgets( ) method. 

Placing a Widget with the Grid Layout Manager 

Next, I start the create_wi dgets () method and create a label that provides instructions to the 
User: 

def create_widgets(self): 

. Create button, text, and entry widgets. . 

# create instruction label 

self.inst_lbl = Label(self, text = "Enter password for the secret of longevity") 

So far, nothing new. But in the next line, 1 use the Grid layout manager to be specific about 
the placement of this label: 

self.inst_lbl.grid(row = 0, column = 0, columnspan = 2, sticky = W) 

A widget objecfs gri d( ) method can take values for many different parameters, but I only 
use four of them: row, coi umn, coi umnspan, and sticky. 
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The row and coi umn parameters take integers and define where an object is placed within its 
master widget. In this program, you can imagine the frame in the root window as a grid, 
divided into rows and columns. At each row and column intersection is a cell, where you can 
place a widget. Figure 10.13 illustrates the placement ofnine Button widgets, in nine different 
cells, using row and column numbers. 




ipP| 

row = 0 
column = 0 

row = 0 
column = 1 

row = 0 
column = 2 

row = 1 
column = 0 

row = 1 
column = 1 

row = 1 
column = 2 

row = 2 
column = 0 

row = 2 
column = 1 

row * 2 
column = 2 


^ Figure 10.13 ) 

Each button Is 
Located in a unique 
ceLL, based on a 
row and a coLumn 
number. 


For my Label widget, I pass 0 to row and 0 to column, which puts the label in the upper-left 
corner of the frame. 

If a widget is very wide (like the long instruction Label widget I have in this program), you 
may want to allow the widget to span more than one cell so that your other widgets are 
correctly spaced. The coi umnspan parameter lets you span a widget over more than one column. 
I pass 2 to this parameter to allow the long label to span two columns. This means that the 
label takes up two cells, the one at row 0, column 0, and the other at row 0, column 1. (You 
can also use the rowspan parameter to allow a widget to span more than one row.) 

Even after youVe established which cell (or cells) a widget occupies, you have the flexibility 
to justify the widget within the cell (or cells) by using the parameter sticky, which takes 
directions as values, including N, S, E, and W. A widget is moved to the quadrant of the cell (or 
cells) that corresponds to the direction. Since I pass W to sti cky for the Label object, the label 
is forced to the west (left). Another way to say this is that the label is left-justified in its cells. 

Next, I create a label that appears in the next row, left-justified: 

# create label for password 

self.pwjbl = Label (self, text = "Password: ") 
self.pw_lbl.grid(row = 1, column = 0, sticky = W) 

Creating an Entry Widget 

Next, I create a new type of widget, an Entry widget: 

# create entry widget to accept password 
self.pw_ent = Entry(self) 
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This code creates a text entry where the user can enter a password. 

I position the Entry widget so that it’s in the cell next to the password label: 

self.pw_ent.grid(row = 1, column = 1, sticky = W) 

Then, I create a hutton that lets the user submit his or her password: 

# create submit button 

self.subtnit_bttn = Button(self, text = "Submit", command = self.reveal) 

I bind the activation of the button with the reveal ( ) method, which reveals the longevity 
secret, if the user has entered the correct password. 

I place the button in the next row, all the way to the left: 

self.submit_bttn.grid(row = 2, column = 0, sticky = W) 

Creating a Text Widget 

Next, I create a new type of widget, a Text widget: 

# create text widget to display message 

self.secret_txt = Text(self, width = 35, height = 5, wrap = WORD) 

I pass values to wi dth and hei ght to set the dimensions of the text box. Then I pass a value to 
the parameter wrap, which determines how text in the box is wrapped. Possible values for the 
parameter are WORD, CHAR, and NONE. WORD, the value 1 use for this Text widget, wraps entire 
words when you reach the right edge of the text box. CHAR wraps characters, meaning that 
when you get to the right edge of the text box, the next character simply appears on the 
following line. NONE means no wrapping. As a resuit, you can only write text on the first line 
of the text box. 

Next, 1 set the text box so that it’s on the next row and spans two columns: 

self.secret_txt.grid(row = 3, column = 0, columnspan = 2, sticky = W) 

Getting and Inserting T ext with T ext-Based Widgets 

Next, 1 write the reveal () method, which tests to see if the user has entered the correct pass¬ 
word. If so, the method displays the secret to a long life. Otherwise, the user is told that the 
password is incorrect. 

The first thing 1 do is get the text in the Entry widget by invoking its get() method: 
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def reveal(self): 

. Display message based on password. . 

contents = self.pw_ent.get() 

The get( ) method returns the text in the widget. Both Entry and Text objects have a get() 
method. 

I check to see if the text is equal to "secret". If so, I set message to the string describing the 
secret to living to 100. Otherwise, I set message to the string that telis the user that he or she 
entered the wrong password. 

if contents == "secret": 

message = "Here's the secret to living to 100: live to 99 " \ 

"and then be VERY careful. " 

el se: 

message = "Thafs not the correct password, so I can't share " \ 

"the secret with you." 

Now that 1 have the string that 1 want to show to the user, 1 need to insert it into the Text 
widget. First, 1 delete any text already in the Text widget by invoking its dei ete() method: 

self.secret_txt.delete(0.0, END) 

The dei ete() method can delete text from text-based widgets. The method can take a single 
index, or a beginning and an ending point. You pass floating-point numbers to represent a 
row and column number pair where the digit to the left of the decimal point is the row 
number and the digit to the right of the decimal point is the column number. For example, 
in the previous line of code, 1 pass 0.0 as the starting point, meaning that the method should 
delete text starting at row 0, column 0 (the absolute beginning) of the text box. 

tki nter provides several constants to help out with this type of method, such as END, which 
means the end of the text. So, this previous line of code deletes everything from the first 
position in the text box to the end. Both Text and Entry widgets have a dei ete() method. 

Next, 1 insert the string 1 want to display into the Text widget: 

self.secret_txt.insert(0.0, message) 

The i nsert() method can insert a string into a text-based widget. The method takes an inser- 
tion position and a string. In the previous line of code, 1 pass 0.0 as the insertion position, 
meaning the method should start inserting at row 0, column 0.1 pass message as the second 
value, so that the appropriate message shows up in the text box. Both Text and Entry widgets 
have an insert() method. 
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The i nsert( ) method doesn’t repLace the text in a text-based widget—it simpLy 
inserts it. If you wantto repLace the existingtext with newtext, first caLL the text- 
based widgefs dei ete( ) method. 


Wrapping Up the Program 

To wrap up the program, I create a root window and set its title and dimensions. Then I create 
a new Appi i cati on object with the root window as its master. Finally, I begin the application 
by starting the window’s event loop. 

# main 
root = Tk() 

root.titleCLongevity") 
root.geometryL"300x150") 

app = Appiication(root) 

root.mainloop() 

UsiNG Check Buttons 

Check buttons allow a user to select any number of choices from a group. While this gives 
the user a lot of flexibility, it actually gives the programmer greater control by limiting to a 
specific list what the user can choose. 

Introducing the Movie Chooser Program 

The Movie Chooser program lets the user choose his or her favorite movie types from a list of 
three: comedy, drama, and romance. Since the program uses check buttons, the user can 
select as many (or as few) as he or she wants. The program displays the results of the user’s 
selections in a text box. Figure 10.14 shows off the program. 


Figure 10.14 ^ 

The resuLts of the 
user’s seLections 
showup in the text 
box. 








Chapter 10 • GUI Development: The Mad Lib Program 



You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 10 folder; the file name is movie_chooser.py. 

Setting Up the Program 

I set up the Movie Chooser program hy importing tki nter and starting my Appi i cati on class 
definition: 

# Movie Chooser 

# Demonstrates check buttons 

frotn tki nter import * 

class Appiication(Frame): 

. GUI Application for favorite movie types. . 

def_init_(self, master): 

super(Appi i cation, self)._init_(master) 

self.grid() 

self.create_widgets() 

Allowing a Widget's Master to Be Its Only Reference 

Next, I create a lahel that describes the program: 

def create_widgets(self): 

. Create widgets for movie type choices. . 

# create description label 
Label (self, 

text = "Choose your favorite movie types" 

).grid(row = 0, column = 0, sticky = W) 

There’s one important difference hetween this label and others fve created: 1 don’t assign the 
resulting Label object to a variahle. Normally, this would he a hig mistake, rendering the 
object useless hecause it wouldn’t be connected to the program in any way. But with tkin- 
ter, a Label object is connected to the program, like all GUI elements, by its master. What 
this means is that if 1 Imow 1 won’t need to directly access a widget, then 1 don’t need to assign 
the object to a variable. The main henefit of this approach is shorter, cleaner code. 

So far, fve been pretty conservative, always assigning each new widget to a variable. But in 
this case, 1 know that Fm not going to need to access this label, so 1 don’t assign the Label 
object to a variable. Instead, 1 let its master maintain the only reference to it. 
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Next, I create another label in much the same way: 

# create instructiori label 
Label(self, 

text = "Select all that apply: " 

).grid(row = 1, column = 0, sticky = W) 

This label provides instructions, telling the user that he or she can select as many movie types 
as apply. 

Creating Check Buttons 

Next, 1 create the check buttons, one for each movie type. 1 first tackle the Comedy check 
button. 

Every check button needs a special object associated with it that automatically reflects the 
check button’s status. The special ohject mustbe an instance of the Bool eanVar class from the 
tki nter module. So, before 1 create the Comedy check button, 1 instantiate aBooleanVar object 
and assign it to a new object attribute, 1 i kes_comedy: 

# create Comedy check button 

sel f. 1 i kes_cotiiedy = BooleanVarO 


/ \ 

In THE Real World 

A Boolean variableis a special kind of variable that can be only true or false. Pro- 
grammersoftencallsucha variablesimplya"Boolean."Thetermisalwayscapitalized 
because it's derived from the name of the English mathematician George Boole. 


Next, 1 create the check button itself: 

Checkbutton(self, 

text = "Comedy", 

variable = self.likes_comedy, 

command = self.update_text 

).grid(row = 2, column = 0, sticky = W) 

This code creates a new check button with the text Comedy. By passing sel f . 1 i kes_comedy to 
the parameter variable,! associate the checkbutton’s status (selected or unchecked) with the 
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1 i kes_coniedy attribute. By passing sel f. update_text() to the parameter command, I bind the 
activation ofthe checkbuttonwiththe update_text() method.This means thatwheneverthe 
User selects or clears the check hutton, the update_text() method is invoked. Finally, I place 
the check button on the next row, ali the way to the left. 

Notice that 1 don’t assign the resulting Checkbutton ohject to a variable. This is fine, because 
what 1 really care about is the status of the button, which 1 can access from the 1 i kes_coni- 
edy attribute. 

1 create the next two check buttons in the same way: 

# create Drama check button 
self.likes_drania = BooleanVarO 
Checkbutton(self, 

text = "Drama", 

variable = sel f .1 i kes_drama, 

command = self.update_text 

).grid(row = 3, column = 0, sticky = W) 

# create Romance check button 

self.1 ikes_romance = BooleanVarO 
Checkbutton(self, 

text = "Romance", 

variable = self.1 ikes_romance, 

command = self.update_text 

).grid(row = 4, column = 0, sticky = W) 

So, whenever the user selects or clears the Drama or Romance check buttons, the update_text 
() method is invoked. And even thoughl don’t assign the resulting Checkbutton objects to any 
variables, 1 can always see the status of the Drama check button through the 1 i kes_drama 
attribute, and 1 can always see the status of the Romance check hutton through the 
1 i kes_romance attribute. 

Finally, 1 create the text box that 1 use to show the results of the user’s selections: 

# create text field to display results 

self.results_txt = Textiself, width = 40, height = 5, wrap = WORD) 
self.results_txt.grid(row = 5, column = 0, columnspan = 3) 
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Getting the Status of a Check Button 

Next, I write the update_text() method, which updates the text hox to reflect the check but- 
tons the user has selected: 

def update_text(self): 

. Update text widget and display user's favorite movie types. . 

likes = "" 

if self .1 i kes_cotiiedy.get(): 

likes += "You like comedic movi es.\n" 

if self.1 ikes_drama.get(): 

likes += "You like dramatic movies.\n" 

if self.1 ikes_romance.get(): 

likes += "You like romantic movi es." 

self.resuits_txt.delete(0.0, END) 
self.results_txt.inserti0.0, likes) 

You can’t access the value ofaBooleanVar object directly. Instead, you must invoke the objecfs 
get() method. In the previous code, luse the get( ) method of the Bool eanVar object refer enced 
byl i kes_comedy to get the objecfs value. If the value evaluates to true, that means the Comedy 
check button is selected, and I add the string "You like comedi c movies.\n'' to the string fm 
building to display in the text hox. I perform similar operations based on the status of the 
Drama and Romance check buttons. Finally, I delete all of the text in the text hox and then 
insert the new string, likes, which I just built. 

Wrapping Up the Program 

I finish the program with the familiar main section. I create a root window and a new Appi i - 
cati on object with the root window as its master. Then, I start the window’s event loop. 

# main 
root = Tk() 

root.titleCMovie Chooser") 
app = Application(root) 
root.mainloop() 
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UsiNG Radio Buttons 

Radio buttons are a lot like check buttons, except that radio buttons only allow one button 
in a group to be selected at once. This is great if you want the user to make a single selection 
from a group of choices. Since radio buttons have so much in common with check buttons, 
learning to use them is pretty straightforward. 

Introducing the Movie Chooser 2 Program 

The Movie Chooser 2 program is like the Movie Chooser program. The user is presented with 
three different movie types from which to select. The difference is that the Movie Chooser 2 
program uses radio buttons instead of check buttons, so the user can select only one movie 
type. This is perfect since the program asks the user for his or her favorite type of movie. 
Figure 10.15 shows off the program. 



Q Figure 10.15 ^ 

The user can 
seLectonLya singLe 
movie type. 


You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 10 folder; the file name is movie_chooser2.py. 

Setting Up the Program 

1 sfart the program by importing the tki nter module: 

# Movie Chooser 2 

# Demonstrates radio buttons 

from tkinter import * 

Next, 1 write the Appi i cati on class. 1 define its constructor, which initializes a new Appi i ca - 
ti on ohject: 

class Appiication(Frame): 

. GUI Application for favorite movie type. . 

def_init_(self, master): 
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. Initialize Frame. . 

super(Appiication, self)._init_(master) 

self.gridO 

self.create_widgets() 

Then, I create labeis that give the user instructioris: 

def create_widgets(self): 

. Create widgets for movie type choices. . 

# create deseription label 
Label(self, 

text = "Choose your favorite type of movie" 

).grid(row = 0, column = 0, sticky = W) 

# create instructior label 
Label(self, 

text = "Select one:" 

).grid(row = 1, column = 0, sticky = W) 

Creating Radio Buttons 

Since only one radio button in a group can be selected at one time, there’s no need for each 
radio button to have its own status variable, as required for check buttons. Instead, a group 
of radio buttons share one, special object that reflects which of the radio buttons is selected. 
This object can be an instance of the Stri ngVar class from the tki nter module, which allows 
a string to be stored and retrieved. So, before 1 create the radio buttons themselves, 1 create 
a single StringVar object for all of the radio buttons to share, assign it to the attribute 
favorite, and setits initialvalue to None using the objecfs setO method: 

# create variable for single, favorite type of movie 
self .favorite = StringVarO 

self.favo rite.set(None) 

Next, 1 create the Comedy radio hutton: 

# create Comedy radio button 
Radiobutton(self, 

text = "Comedy", 

variable = self.favorite, 

value = "comedy.", 

command = self.update_text 

).grid(row = 2, column = 0, sticky = W) 
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A radio button’s va ri ab 1 e option defines the special variable associated with the radio button, 
while a radio button’s v a 1 u e option defines the value to be stored by the special variable when 
the radio button is selected. So, by setting this radio button’s variable option to 
sel f. favori te and its value option to "comedy.", Fm sa 5 dng that when the Comedy radio but¬ 
ton is selected, the Stri ngVar referenced by sel f. favori te should store the string "comedy." 

Next, 1 create the other two radio buttons: 

# create Drama radio button 
Radiobutton(self, 

text = "Drama", 

variable = self.favorite, 

value = "drama.", 

command = self.update_text 

).grid(row = 3, column = 0, sticky = W) 

# create Romance radio button 
Radiobutton(self, 

text = "Romance", 

variable = self.favorite, 

value = "romance.", 

command = self.update_text 

).grid(row = 4, column = 0, sticky = W) 

By setting the Drama radio button’s vari abi e option to sel f. favori te and its val ue option to 
"drama.", Fm saying that when the Drama radio button is selected, the Stri ngVar referenced 
by sel f. favori te should store the string "drama." 

And by setting the Romance radio button’s variable option to self.favorite and its value 
option to " romance.", Fm sa 5 dng that when the Romance radio button is selected, the Stri ng¬ 
Var referenced by sel f. favori te should store the string " romance.". 

Next, 1 create the text box to display the results of the user’s selection: 

# create text field to display resuit 

self.results_txt = Text(self, width = 40, height = 5, wrap = WORD) 
self.results_txt.grid(row = 5, column = 0, columnspan = 3) 

Getting a Value from a Group of Radio Buttons 

Getting a value from a group of radio buttons is as simple as invoking the get() method of 
the Stri ngVar object that they all share: 
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def update_text(self): 

. Update text area and display user's favorite movie type. . 

message = "Your favorite type of movie is " 
message += self.favorite.getO 

When the Comedy radio button is selected, sel f. favori te. get( ) returns "comedy .when the 
Drama radio button is selected, sel f. favori te.get( ) returns "drama .and when the Romance 
radio button is selected, sel f. favori te.get ( ) returns "romance.". 

Next, I delete any text that may be in the text box and insert the string 1 just created, which 
declares the user’s favorite movie type: 

self.resuits_txt.delete(0.0, END) 
self.resuits_txt.insert(0.0, message) 

Wrapping Up the Program 

1 wrap up the program by creating a root window and a new Appi i cati on object. Then, 1 begin 
the root window’s event loop to start up the GUI. 

# main 
root = Tk() 

root.titleCMovie Chooser 2") 
app = Application(root) 
root.mainloop() 

Back to THE Mad Lib Program 

Now that youVe seen a nice variety of widgets used in isolation, it’s time to combine them 
in one, larger GUI. 1 don’t introduce any new concepts in the Mad Lib program, so 1 don’t 
comment too much on the code. You can find the code for the program on the companion 
website (www.courseptr.com/downloads) in the Chapter 10 folder; the file name is 
mad_lib.py.py. 

Importing the tkinter Module 

As you probably know by now, you have to import the tkinter module before you can use it: 

# Mad Lib 

# Create a story based on user input 


★ 


from tkinter import 
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The Application CLass's Constructor Method 

Like all other Appi i cati on class constructors before it, this one initializes the newly created 
Appi i cati on object and invokes its create_wi dgets () method: 

class Appiication(Frame): 

. GUI application that creates a story based on user input. . 

def_init_(self, master): 

. Initialize Frame. . 

super(Appi i cation, self)._init_(master) 

self.gridO 

self.create_widgets() 

The Application Class's create_widgets() Method 

This class creates all of the widgets in the GUI. The only new thing 1 do is create all three radio 
buttons in a loop by moving through a list of strings for each radio button’s text and val ue 
options: 

def create_widgets(self): 

. Create widgets to get story information and to display story. . 

# create instruction label 
Label (self, 

text = "Enter information for a new story" 

).grid(row = 0, column = 0, columnspan = 2, sticky = W) 

# create a label and text entry for the name of a person 
Label (self, 

text = "Person: " 

).grid(row = 1, column = 0, sticky = W) 
self.person_ent = Entry(self) 

self.person_ent.grid(row = 1, column = 1, sticky = W) 

# create a label and text entry for a plural noun 
Label (self, 

text = "P1ural Noun:" 

).grid(row = 2, column = 0, sticky = W) 
self.noun_ent = Entry(self) 

self.noun_ent.grid(row = 2, column = 1, sticky = W) 


# create a label and text entry for a verb 
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Label(self, 

text = "Verb:" 

).grid(row = 3, column = 0, sticky = W) 
self.verb_ent = Entry(self) 

self.verb_ent.grid(row = 3, column = 1, sticky = W) 

# create a label for adjectives check buttons 
Label(self, 

text = "Adjective(s):" 

).grid(row = 4, column = 0, sticky = W) 


# create itchy check button 
sel f. is_i tchy = BooleanVarO 
Checkbutton(self, 

text = "itchy", 

variable = self.is_itchy 

).grid(row = 4, column = 1, sticky = W) 

# create joyous check button 
sel f. is_joyous = BooleanVarO 
Checkbutton(self, 

text = "joyous", 

variable = self.is_joyous 

).grid(row = 4, column = 2, sticky = W) 


# create electric check button 
self.is_electric = BooleanVarO 
Checkbutton(self, 

text = "electric", 

variable = self.is_electric 

).grid(row = 4, column = 3, sticky = W) 


# create a label for body parts radio buttons 
Label(self, 

text = "Body Part:" 

).grid(row = 5, column = 0, sticky = W) 

# create variable for single body part 
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self.body_part = StringVarO 
self.body_part.set(None) 

# create body part radio buttons 

body_parts = ["bellybutton", "big toe", "medulla oblongata"] 
coiumn = 1 

for part in body_parts: 

Radiobutton(self, 

text = part, 

variable = self.body_part, 
value = part 

).grid(row = 5, column = column, sticky = W) 

coiumn += 1 

# create a submit button 
Button(self, 

text = "Click for story", 
command = self.tell_story 
).grid(row = 6, column = 0, sticky = W) 

self.story_txt = Text(self, width = 75, height = 10, wrap = WORD) 
self.story_txt.grid(row = 7, column = 0, columnspan = 4) 

The Application Class's tell_story() Method 

In this method, I get the values the user has entered and use them to create the one, long 
string for the story. Then, I delete any text in the text hox and insert the new string to show 
the user the story he or she created. 

def tell_story(self): 

. Fili text box with new story based on user input. . 

# get values from the GUI 
person = self.person_ent.get() 
noun = self.noun_ent.get() 
verb = self.verb_ent.get() 
adjecti ves = 

if self.is_itchy.get(): 

adjectives += "itchy, " 
if self.is_joyous.get(): 
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adjectives += "joyous, " 
if self.is_electric.get(): 

adjectives += "electric, " 
body_part = self.body_part.get() 


# create the story 

story = "The famous explorer " 

story += person 

story += " had nearly given up a life-long quest to find The Lost City of 

story += noun.titleO 

story += " when one day, the " 

story += noun 

story += " found " 

story += person + "." 

story += "A strong, " 

story += adjectives 

story += "peculiar feeling overwhelmed the explorer. " 

story += "After ali this time, the quest was finally over. A tear came to 

story += person + "'s " 

story += body_part + ". " 

story += "And then, the " 

story += noun 

story += " promptiy devoured " 
story += person + "." 

story += "The moral of the story? Be careful what you " 
story += verb 
story += " for." 


# display the story 
self.story_txt.delete(0.0, END) 
self.story_txt.inserti0.0, story) 

The Main Part of the Program 

YouVe seen this code more than a few times before. I create a root window and an Appi i ca - 
ti on instance. Then, I start the whole GUI up by invoking roofs mai nl oop() method. 
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# main 
root = Tk() 
root.titleCMad Lib") 
app = Appi i cation(root) 
root.mainloopl) 

SUMMARY 

In this chapter, you learned about creating GUIs. First, you learned about event-driven pro- 
gramming, a new way to think about writing code. Then, you learned about a number of GUI 
widgets, includingframes,buttons, text entries, textboxes, checkbuttons, and radio buttons. 
You saw how to customize widgets. You also saw how to organize them in a frame, using the 
Gri d layout manager. You learned how to bind events to event handlers so that widgets do 
something when activated. Finally, you saw how to put together a fairly complex GUI to create 
a fun Mad Lib program. 


f y 

Challenges 

1. Writeyourown version of the Mad Lib program usinga different 
arrangement of widgets. 

2. Write a version of the Guess My Number game, the Chapter 3 
project, usinga GUI. 

3. Create a GUI program, Order Up!, that presents the user with 
a simple restaurant menu, which lists items and prices. Let the 
user select different items and then show the user the total 
bili. 
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Graphics: The Pizza 
Panic Game 


T he maj ority of programs youVe seen so far have focused on presenting text, 
but today people expect rich, visual content from their programs, regard- 
less of the applicatiori. In this chapter, you’11 learn how to use graphics 
with the help of a few multimedia modules designed for writing games in Python. 
Specifically, you’11 learn to do the following: 

• Create a graphics window 
• Create and manipulate sprites 
• Display text in a graphics window 
• Test for collisions between sprites 
• Handle mouse input 
• Control a computer opponent 

InTRODUCING THE PlZZA PaNIC GaME 

The project for this chapter, the Pizza Panic game, involves a crazy chef, a deep- 
dish pan, and a bunch of flying pizzas. Here’s the scenario: After being pushed over 
the edge by one-too-many finicky diners, the chef at the local pizza parior has taken 
to the rooftop and is madly flinging pizzas to their doom. Of course, the pizzas 
must be saved. Using the mouse, the player Controls a pan that he or she maneuvers 
to catch the falling pizzas. The player’s score increases with every pizza caught, 
but, once a pie hits the ground, the game is over. Figures 11.1 and 11.2 show the 
game in aedon. 
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Q Figure ii.i ^ 

The pLayer must 
catch the faLLIng 
pizzas. 



Q Figure 11.2 ^ 

Once the pLayer 
misses a plzza, the 
game Is over. 
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InTRODUCING THE PYGAME AND LIVEWIRES PaCKAGES 

pygame and livewires are sets of modules (called packages) that give Python programmers 
access to a wide range of multimedia classes. With these classes, you can create programs 
with graphics, sound effects, music, and animation. The packages also allow input from a 
variety of devices, including the mouse and keyboard. With these packages, you won’t have 
to worry about the lowTevel hardware details, like what Idnd of graphics card the player 
has—or whether he or she has a graphics card at all. Instead, you can concentrate on the 
program logic and get to writing games fast. 

pygame is the secret weapon in your media arsenal. Written by Pete Shinners, the package 
allows you to write impressive multimedia programs in Python. Because the package is so 
powerful, however, it can be a bit overwhelming for the new programmer. 

livewires, written by a group of educators in the United Kingdom, was designed to take 
advantage of the power of pygame while reducing the complexity for the programmer. 
1 i vewi res provides a simplerwayto get started programming games with graphics and sound. 
And even though you won’t directly access pygame, it will stili be there, working hard behind 
the scenes. 

You need to install both pygame and 1 i vewi res before you can run the programs presented 
in this chapter. Fortunately, versions of both are on the companion website 
(www.courseptr.com/downloads) in the Software folder. Just follow the installation instruc- 
tions that accompany the packages. 



ALthough you're weLcome to visit the website of the LiveWires organization at 
http://www.Livewires.org.uk, be aware that the 1 i vewi res package incLuded on 
the companion website (www.courseptr.com/downLoads) is a modified version 
of the package that LiveWires created. I updated the package to make it even 
easier for new programmers to use. And don't worry—l've incLuded a modified 
version of the documentation in Appendix B. 


If you want to learn more about pygame, visit its website at http://www.pygame.org. 

Creating a Graphics Window 

Before you can display any graphics, you must first create a graphics window—your blank 
canvas on which to display text and images. 
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Introducing the New Graphics Window Program 

Creating a graphics window with the 1 i vewi res package is a snap. The New Graphics Window 
program creates an empty graphics window in just a few lines of code. Figure 11.3 shows the 
results of the program. 




Just as with a program that uses Tkinter to create a new window, you shouLdn't 
run a 1 i vewi res program from IDLE. If you're using Windows, create a batch file 
that runs your Python program and then pauses. To review writing such a batch 
file, see "Introducing the Simple GUI Program" in Chapter I 0. 


You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 11 folder; the file name is new_graphics_window.py. 

Importing the games Module 

The 1 i vewi res package is made up of several important modules, including games, which con- 
tains a group of ohjects and classes for game programming. You can import a specific module 
of a package by using the f rom statement. To import a module, use f rom, followed by a package 
name, followed by import, followed by a module name (or a list of module names separated 
by commas). 
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The first thing I do in the program is import the gatnes module of the 1 i vewi res package: 

# New Graphics Window 

# Demonstrates creating a graphics window 

from 1 ivewires import games 

As a resuit, 1 can use games like any other module 1 import. To get an overview of the games 
module, check out Table 11.1, which lists useful games objects, and Table 11.2, which lists 
useful games classes. 




Initializing the Graphics Screen 

Next, 1 initialize the graphics screen: 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

When you call the games i ni t( ) function, you create a new graphics screen. The width of the 
screen is determined by the value you pass screen_wi dth, while (drumroll, please) the height 
of the screen is determined by the value you pass screen_hei ght. The screen dimensions are 
measured inpixels—a single point in a graphics area. The value you pass fps (short for “frames 
per second”) is the number of times the screen will update itself every second. 
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Starting the Main Loop 

The final line in the program is 
ganies.screen.mainloop() 

screen is the games ohject that represents the graphics screen. mai nl oop( ) is the workhorse of 
screen and updates the graphics window, redrawing ever 5 d;hing fps times per second. So, this 
last line keeps the graphics window open and updates the screen 50 times per second. Check 
out Table 11.3 for a few screen properties. For a list of useful screen methods, see Table 11.4. 


Table I I .3 Useful screen Properties 


f 

Property 

width 
height 
fps 

background 
ali objects 
event_grab 

A 

Description 

Width of screen. 

Height of screen. 

Frames per second screen is updated. 

Background image of screen. 

List of aLL the sprites on the screen. 

Boolean that determines ifinput is grabbedto screen. Trueforinputgrabbedto screen. 

Fal se for input not grabbed to screen. 




Table I 1.4 Useful screen Methods 


f 

Method 

addisprite) 

A 

Description 

Adds sprite.a Spri te object (or an object of a Spri te subcLass), to the graphics 

screen. 

clear() 
mainloopO 
quit() 

Removes ali sprites from the graphics screen. 

Starts the graphics screen’s main Loop. 

Closes the graphics window. 




Setting a Background Image 

A blank screen is ali well and good, if your goal is to create the world’s most boring program. 
Fortunately, the screen ohject has a property for its background image. 
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Introducing the Background Image Program 

The Background Image program is just a modification of the New Graphics Window program. 
I add a hackground image to the graphics screen, shown in Figure 11.4. 



^ Figureii.4 ) 

By using the 

background 

property of the 
screen object, I 
appLy a 

background image 
to the graphics 
window. 


To create the Background Image program, I add two lines to the New Graphics Window pro¬ 
gram, just before invoking mainloopO. You can find the code for the program on the 
companion website (www.courseptr.com/downIoads) in the Ghapter 11 folder; the file name 
is background_image.py. 

# Background Image 

# Demonstrates setting the background image of a graphics screen 
from livewires import games 

ganies.init(screen_width = 640, screen_height = 480, fps = 50) 

wall_image = games.1oad_image("wal1.jpg", transparent = False) 
games.screen.background = wall_image 


games. screen. mainloopO 





Python Programming for the Absolute Beginner, Third Edition 



Loading an Image 

Before you can do anything with an image, like set it as the background of a graphics screen, 
you have to load the image into memory to create an image object. I load an image by adding 
the following line right after I initialize the graphics window: 

wall_image = ganies.load_iniage("wall .jpg", transparent = False) 

This calls the games 1 oad_iniage( ) function, which loads the image stored in the file wal 1 .jpg 
into memory and assigns the resulting image object to wal l_image. 



Make sure that any file you wantyour Python program to access is associated 
with the correct path information, as you Learned in Chapter 7, in the section 
"Opening and CLosing a File." The simpLest file management soLution, and the 
one I use here, is to store image files in the same foLder with the program that 
Loads them. If you foLLow this method, you won't need to worry about path in¬ 
formation at aLL. 


The 1 oad_image( ) function takes two arguments: a string for the file name of the image 
and True or False for transparent. Fll go over exactly what transparent means a bit later 
in this chapter. For now, just remember this rule: Always load a background image with 
transparent = False. 

YouTl notice that 1 load a JPEG image for the background in this program. However, you’re 
not restricted to JPEGs when using the 1 oad_i mage( ) function. It works just as well with many 
other image file types, including BMP, GIF, PNG, PGX, and TGA. 

Setting the Background 

In order to set an image object as the screen background, you just need to use the screen 
background property. 1 add the following line right after 1 load the image: 

games.screen.background = wall_image 

This sets the background of the screen to the image object wal l_i mage. 

When the program encounters mai nl oop( ), it keeps the graphics window open, with its new 
background image, for all to see. 

UnDERSTANDING THE GRAPHICS COORDINATE SySTEM 

So far, Fve created several graphics screens, each time with a width of 640 and a height of 
480, but 1 havenT said much about them beyond that. Now weTl take a closer look at the 
screen and its coordinate system. 
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You can think of a graphics screen as a grid, 640 columns across by 480 rows down. Each 
intersection of a column and a row is a location on the screen, a single point or pixel. When 
you talk about a specific point on the screen, you give two coordinates: an x, which represents 
the column, and a y, which represents the row. You start counting coordinates from the upper- 
left corner of the screen. So, the upper-leftmost point is where the x-coordinate is 0 and the 
y-coordinate is 0, which you write as the pair (0,0). As you move to the right, the x values 
increase. As you move down the screen, the y values increase. That makes the point in the 
lower-right corner (639,479). Figure 11.5 gives a visual representation of the graphics screen 
coordinate system. 
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Q Figure 11.5 ^ 

You specify pomts 
on a graphics 
screen with x- and 
y-coordinate pairs. 


You can place graphics objects, like the image of a pizza or the red-colored text “Game Over,” 
on the screen using the coordinate system. The center of a graphics object is placed at the 
specified coordinates. YouTl see exactly how this works in the next program. 

Displaying a Sprite 

Background images can spruce up a plain graphics screen, but even a breathtaking back- 
ground is stili just a static image. A graphics screen with only a background image is like an 
empty stage. What you need are some actors. Enter the sprite. 
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Asprite is a graphics object with an image that can make programs really come alive. Sprites 
are used in games, entertainment Software, presentations, and ali over the web. In fact, you’ve 
already seen examples of sprites in the Pizza Panic game. The crazy chef, pan, and pizzas are 
ali sprites. 


/ \ 

In THE Real World 

Sprites aren't just for games. There are plenty of places in non-entertainment Soft¬ 
ware wherethey're used...or misused. In fact. you probably knowthe most Infamous 
sprite in appllcatlon Software history, Clippy the Office Assistant—the animated 
paperclip meant togive helpfulsuggestlons in Microsoft Office. However, many peo- 
ple found Clippy obtrusive and irritating. One major online publication even ran an 
articleentitled''KillClippy!" Well, Microsoft finally sawthe light. Starting with Office 
2007, Clippy is no longer available. So, while graphics can makea program more inter- 
esting, remember: Use your sprite powers for good instead of evil. 


While it wouid be cool to see a bunch of sprites flying around and crashing into each other, 
I start with the first step: displaying a single, nonmoving sprite. 

Introducing the Pizza Sprite Program 

In the Pizza Sprite program, I create a graphics window and set a hackground image, just like 
before. Following this step, however, I create a pizza sprite right in the middle of the screen. 
Figure 11.6 shows the results of the program. 

The Pizza Sprite program is just a modification of the Background Image program. I add only 
three lines to get the new sprite on the screen, justhefore invoking mainl oop( ). You can find 
the code for the program on the companion website (www.courseptr.com/downloads) in the 
Chapter 11 folder; the file name is pizza_sprite.py. 
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^ Figureii.6 ) 

The pizza image is 
not part of the 
background, but 
an independent 
object of the 
Spri te cLass. 


# Pizza Sprite 

# Demonstrates creating a sprite 
from livewires import games 

gaines.init(screen_width = 640, screen_height = 480, fps = 50) 

wall_iniage = games.1 oad_iniage("wal 1 .jpg", transparent = False) 
games.screen.background = wall_image 

pizza_image = games.load_image("pizza.bmp'') 

pizza = games.Sprite(image = pizza_image, x = 320, y = 240) 

games.screen.add(pizza) 

games. screen. ma i nloopO 

Loading an Image for a Sprite 

First, I load a pizza image into memory to create an image object: 
pizza_image = games.load_image("pizza.bmp") 
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You’ll notice one small difference in the way I load a background image. This time, I didn’t 
include a value for transparent. The default value is True, so the image is loaded with trans- 
parency on. 

When an image is loaded with transparency on, it’s displayed on a graphics screen so that 
the hackground image shows through its transparent parts. This is great for irregular sprites 
that aren’t perfect rectangles and sprites with “holes” in them, like, say, a Swiss cheese sprite. 

The parts of an image that are transparent are defined by their color. If an image is loaded 
with transparency on, then the color of the point at the upperTeft corner of the image is its 
transparent color. All parts of the image that are this transparent color will allow the back¬ 
ground of the screen to show through. Figure 11.7 shows a Swiss cheese sprite on a solid, 
white background, ready to take advantage of transparency. 


Q Figure 11.7 ^ 

A cheesy sprite 
drawn on a soLid- 
coLor background 
to take advantage 
of transparency. 



If 1 load this Swiss cheese image with transparency on, every part that is pure white (the color 
taken from the pixel in the image’s upper-left corner) will be transparent when the sprite is 
displayed on a graphics screen. The background image will show through these transparent 
parts. Figure 11.8 shows how the image looks when loaded with transparency on and off. 

As a general rule, youTl want to create your sprite image on a solid color that is not used in 
any other part of the image. 



Make sure your sprite image doesn't also contain the coLoryouYe using for trans¬ 
parency. Otherwise, those parts of the sprite wiLL become transparent too, 
making your sprite Look Like it has smaLL hoLes or tears in it as the background 
image of the graphics screen shows through. 
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^ Figure 11.8 ) 

On the Left, the 
image is Loaded 
with transparency 
on. On the right, 
the same image is 
Loaded with 
transparency off. 


Creating a Sprite 

Next, I create a pizza sprite: 

pizza = games.Spritedmage = pizza_image, x = 320, y = 240) 

A new Spri te object is created with the image of a pizza and x- and y-coordinates of (320,240), 
which puts it right in the middle ofthe screen.The new object is then assigned to pi zza. When 
you create a Spri te object, you should pass at least an image, an x-coordinate, and a y-coor- 
dinate to the class constructor. 

Adding a Sprite to the Screen 

After you create a sprite, you need to add it to the screen so it can be seen and updated, which 
is exactly what I do in the next line: 

gatnes. screen. add(pi zza) 

The add( ) method simply adds a sprite to the graphics screen. 

You don't need to be an artist to create graphics for your games. As you see in 
this chapter, I make up for my utter Lack of artistic abiLity with a modern piece of 
technoLogy: my digitaL camera. If you have access to a digitaL camera, you can 
create some great images foryour projects. In fact, that's how I created aLL ofthe 
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graphics for the Pizza Panic game. The brick waLL is the back of a friend’s house. 
For the pizza, I ordered deLivery one night. And the chef is my brave, bravefriend, 
Dave. 

WhiLe this is a great technique, an important thing to remember is that, if you 
take a picture of a person or object, you don't necessariLy own the image—obvi- 
ousLy, some things are trademarked or copyrighted. Using a digitaL camera, 
however, is a great way to capture generic images whiLe infusingyour programs 
with a unique, photoreaListic style. 


Table 11.5 lists useful Spri te properties while Table 11.6 lists useful Spri te methods. 



Table 1 1 .6 Useful Sprite Methods 

f - 


- \ 

Method 

Description 

1 

update() 

Updates sprite. AutomaticalLy calLed every Itai nl OOp ( ) cycle. 


destroy() 

Removes sprite from the screen. 




_ ) 
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Displaying Text 

Whether you need to show off the numbers for a sales presentation or the number of aliens 
obliterated, there are times when you’ll want to display text on a graphics screen. The games 
module contains a class that allows you to do just that, aptly named Text. 

Introducing the Big Score Program 

Displaying text on the graphics screen is just a matter of creating an ohject of the Text class. 
The Big Score program is a modification of the Background Image program. 1 display a score 
in the upper-right corner of the screen, just like in many classic arcade games. Figure 11.9 
shows the results. 



Q Figure 11.9 ) 

The ImpressiveLy 
high score Is 
dispLayed after a 
Text object Is 
instantlated. 


You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 11 folder; the file name is big_score.py. 

# Big Score 

# Demonstrates displaying text on a graphics screen 


from livewires import games, color 
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ganies.init(screen_width = 640, screen_height = 480, fps = 50) 

wall_image = ganies.load_iniage(''wall .jpg", transparent = False) 
games.screen.background = wall_iniage 

score = games.Text(value = 1756521, 
size = 60, 

color = color.black, 

X = 550, 
y = 30) 

games.screen.addisco re) 
games.screen.mainloopl) 

Importing the color Module 

The 1 ivewires package contains another module, color, whichdeflues aset ofcoustauts that 
represeut differeut colors. These colors cau be used with certaiu graphics objects, iucludiug 
auy Text or Message object. For a complete list of predefiued colors, see the 1 i vewi res docu- 
meutatiou iu Appeudix B. 

To choose from a group of possible colors, 1 import the color module by replaciug the 
i mport liue at the top of the program with: 

from 1 ivewires import games, color 

Both the color aud games modules are loaded from the 1 i vewi res package. 

Creating a Text Object 

A Text object represeuts text ou the graphics screeu. Just before 1 iuvoke mai nl oop( ), 1 create 
a Text object aud assigu it to score: 

score = games.Textlvalue = 1756521, 
size = 60, 

color = color.black, 

X = 550, 
y = 30) 

At a miuimum, you should pass the coustructor method for a Text object, a value to be dis- 
played as text, a fout size, a color, au x-coordiuate, aud a y-coordiuate. 
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I pass the integer 1756521 to text so that the characters that make up the number will be 
displayed. (A Text object will be displayed as the string representation of whatever you pass 
val ue.) Then 1 pass 60 to si ze, which represents the height of the text in pixels, so the font is 
nice andbig, to match the score. 1 pass coi or the constant coi or. bl ack from the coi or module 
to make the text—you guessed it—black. 1 pass 550 to x and 30 to y, placing the center of the 
object at the coordinates (550,30). This puts the text in the upper-right corner of the graphics 
window. 

Adding a Text Object to the Screen 

In the next line of code, 1 add the new object to the screen so it will be displayed; 
games.screen.adcKscore) 

Once mai nl oop( ) is invoked, the graphics window is displayed along with score. 

Since Text is a subclass of Spri te, Text inherits all of Spri te’s properties, attributes, and meth- 
ods. Table 11.7 lists two additional Text properties that the class defines. 



Displaying a Message 

You may want to display some text on the screen for only a brief period of time. You might 
want to Show a message saying “All records have been updated” or “Attack Wave Seven Com¬ 
plete!” The games class Message is perfect for creating temporary messages just like these. 

Introducing the You Won Program 

The You Won program is a modified version of the Background Image program. 1 instantiate 
a Message object right before invoking mai nl oop( ) to display the text “You won!” in hig, red 
letters. The message is displayed for about five seconds and then the program ends. 
Figure 11.10 illustrates the program. 
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You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 11 folder; the file name is you_won.py. 

# You Won 

# Demonstrates displaying a message 
from livewires import games, color 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

wall_image = games.load_iniage("wall.jpg", transparent = False) 
games.screen.background = wall_image 

won_message = games.Message(value = "You won!", 

size = 100, 
color = color.red, 

X = games.screen.width/2, 
y = games.screen.height/2, 

1 i feti me = 250, 
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after_death = games.screen.quit) 
gaines.screen.add(won_message) 

games.screen.mainloopO 

Importing the color Module 

Message objects, like Text objects, have a color property. To choose from a group of possible 
colors, I import the color module by replacing the i mport line at the top of the program with. 

from livewires import games, color 

Creating a Message Object 

Messages are created from the games class Message. A message is a special kind of Text object 
that destroys itself after a set period of time. A message can also specify a method or a function 
to be executed after the ohject destroys itself. 

The constructor method for Message takes all of the values you saw with Text, hut adds two 
more: 1 i feti me and after_death. 1 i feti me takes an integer value that represents howlong the 
message should he displayed, measured in mainloopO cycles. after_death can be passed a 
method or function to be executed after the Message object destroys itself. The default value 
for after_death is None, so a value isn’t required. 

1 create this Message ohject right before 1 invoke mai nl oop(): 

won_message = games.Messageivalue = "You won!", 

size = 100, 

color = color.red, 

x = games.screen.width/2, 

y = games.screen.height/2, 

1 i feti me = 250, 

after_death = games.screen.quit) 

This creates the message “You Won!” in big, red letters at the center of the screen for ahout 
five seconds, after which the program ends. 

This code instantiates a new Message object with a 1 ifetime attribute set to 250. This means 
that the object will live for about five seconds, because mainloop( ) runs at 50 frames per 
second. After the five seconds, games. screen .qui t( ) is called, since 1 pass that method’s name 
to after_death. At that point, the screen and all of its associated objects are destroyed and the 
program ends. 
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Make sure to pass after_death justthe name of the function or methodyou want 
caLLed after the Message object disappears. Don’t include a set of parentheses 
after the name. 


Using the Screen's Width and Height 

The screen object has a width property, which represents the width of the graphics screen, 
and a height property, which represents the height of the graphics screen. Sometimes it’s 
clearer to use these properties rather than literal integers when you specify a location on the 
screen. 

I use these properties when I pass values for the location of the new Message object, with x = 
games.screen.width/2, and y = games.screen.height/2. By setting the x-coordinate to half of 
the screen width and the y-coordinate to half of the screen height, 1 put the object right in 
the middle of the screen. You can use this technique to put an object in the middle of the 
graphics screen, independent of the actual screen width and height. 

Adding a Message Object to the Screen 

In the next line of code, 1 add the new object to the screen so it will be displayed: 
games.screen.add(won_message) 

Message is a subclass of Text. This means that Message inherits all of Texfs properties, 
attributes, and methods. Table 11.8 lists two additional Message attributes. 



Table 1 1.8 Additional Message Attributes ^ 

f - 

-> 

Attributes 

Descriptiori 

1 i feti me 

NurnberofmainlOOpi ) cycLes before object destroys itself. 0 means ne ver destroy 


itself. The default value is 0. 

after_death 

Function or method to be run after object destroys itself. The default value is None. 




Moving Sprites 

Moving images are the essence of most games—most forms of entertainment, for that matter. 
With sprites, going from stationary to moving is easy. Sprite objects have properties that 
allow them to move around a graphics screen. 
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Introducing the Moving Pizza Program 

This new program is a modification of the Pizza Sprite program. In this program, the pizza 
moves down and to the right. Ali I need to do is change a few lines of code to get the pizza to 
move. Thafs the power of sprites. Figure 11.11 illustrates the program. 



Q Figure ii.ii ^ 

The pizza moves 
down and to the 
right in the 
direction of the 
arrow. 


You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 11 folder; the file name is moving_pizza.py. 

# Moving Pizza 

# Demonstrates sprite velocities 
from livewires import games 

ganies.init(screen_width = 640, screen_height = 480, fps = 50) 

wall_iniage = games.1 oad_iniage("wal 1 .jpg", transparent = False) 
games.screen.background = wall_image 


pizza_image = games.load_image("pizza.bmp'') 
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the_pizza = games.Spritedmage = pizza_image, 

X = games.screen.width/2, 
y = games.screen.height/2, 
dx = 1, 
dy = 1) 

games.screen.add(the_pizza) 
ganies.screen.mainloop() 

Setting a Spnte's Velocity Values 

All I have to do is modify the code that creates a new sprite by providing additional values for 
dx and dy to the constructor method: 

the_pizza = games.Spritedmage = pizza_image, 

X = games.screen.width/2, 
y = games.screen.height/2, 
dx = 1, 
dy = 1) 

Every objectbased on Sprite has dx and dy properties for the objecfs velocity along the x and 
y axes, respectively. (“d,” by the way, stands for “delta,” which means a change.) So, dx is the 
change in the objecfs x-coordinate and dy is the change in the objecfs y-coordinate each time 
screen is updated by mai nl oopO. A positive value for dx moves the sprite to the right, while a 
negative value moves it to the left. A positive value for dy moves the sprite dovm, while a 
negative value moves it up. 

Back in the Pizza Sprite program, 1 didn’t pass any values for dx or dy. Although the sprite in 
that program did have dx and dy properties, they both had the default value of 0. 

Since 1 pass 1 to dx and 1 to dy, every time the graphics window is updated by mai nl oop( ), the 
pizza’s x-coordinate is increased by 1 and its y-coordinate is increased by 1 , moving the sprite 
right and down. 

Dealing with Screen Boundaries 

If you watch the Moving Pizza program run for any length of time, you may notice that once 
the pizza hits a screen boundary, it keeps going. In fact, it disappears out of sight. 

Whenever you set a sprite in motion, you should create a mechanism to deal with the graphics 
window’s boundaries. You have a few choices. A moving sprite could simply stop when it 
reaches the edge of the screen. It could die in, say, a fiery explosion. It could bounce, like a 
giant rubber ball. It could even wrap around the screen so that, just as it disappears off one 
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edge, it reappears on the opposite. What seems to make the most sense for a pizza? Bouncing, 
of course. 

The Bouncing Pizza Program 

When I say that a sprite “bounces” off the edges of the graphics window, I mean that when 
it reaches a screen boundary, it should reverse the velocity component that was moving it 
toward that boundary. So, if the bouncing pizza sprite reaches the top or hottom screen edge, 
it should reverse its dy property. When it reaches the sides of the screen, it should reverse its 
dx. Figure 11.12 illustrates the Bouncing Pizza program. 



Q Figure 11.12 ^ 

Though you can't 
teLL from the 
screen shot, the 
pizza bounces 
around, foLLowing 
the path of the 
arrow. 


You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 11 folder; the file name is houncing_pizza.py. 

Setting Up the Program 

1 begin as 1 would with any other graphics program: 

# Bouncing Pizza 

# Demonstrates dealing with screen boundaries 
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from livewires import games 

ganies.init(screen_width = 640, screen_height = 480, fps = 50) 

As before, the previous lines give me access to the games module and create the graphics screen. 

Deriving a New Class from Sprite 

For the first time, 1 want a sprite to do something it isn’t programmed to do: bounce. So, 1 
need to derive a new class from Sprite. Since 1 want a bouncing pizza, 1 call the new 
class Pizza: 

class PizzaCgames.Sprite): 

. A bouncing pizza. . 

Overridingthe update() Method 

1 need to add just a single method to the Pi zza class to turn a moving pizza into a bouncing 
one. Every time the graphics window is updated hy mainloop( ), the following two things 
happen: 

• Each sprite’s position is updated based on its dx and dy properties 

• Each sprite’s update( ) method is called 

Every Spri te object has an update() method; it just does nothing by default. So, by overriding 
updateO in Pizza, 1 get the perfect place to put code that will handle screen boundary 
checking. 

def update(self): 

. Reverse a velocity component if edge of screen reached. . 

if self.right > games.screen.width or self.left < 0: 
self.dx = -self.dx 

if self.bottom > games.screen.height or self.top < 0: 
self.dy = -self.dy 

In the method, 1 check to see if the sprite is about to go beyond the screen limits in any 
direction. If so, 1 reverse the responsible velocity. 

If the objecfs ri ght property, which represents the x-coordinate of its right edge, is greater 
than games. screen .wi dth, then the pizza is about to go off the right edge into ohlivion. If the 
objecfs 1 eft property, which represents the x-coordinate of its left edge, is less than 0, then 
the pizza is headed off the screen to the left. In either case, 1 simply reverse dx, the pizza’s 
horizontal velocity, to “bounce” the pizza off the screen boundary. 
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Ifthe objecfs bottom property, which represents the y-coordinate ofits bottom edge, is greater 
than games. screen. hei ght, then the pizza is about to go off the bottom edge into oblivion. If 
the objecfs top property, which represents the y-coordinate of its top edge, is less than 0, then 
the pizza is headed off the top of the screen. In either case, I simply reverse dy, the pizza’s 
vertical velocity, to “bounce” the pizza off the screen boundary. 

Wrapping Up the Program 

Since I define a class in the program, I thought Fd organize the rest of the code into a function: 
def maini): 

wall_image = games.load_itnage("wall .jpg", transparent = False) 
games.screen.background = wall_image 

pizza_image = games.load_image("pizza.bmp") 
the_pizza = Pizzadmage = pizza_image, 

X = games.screen.width/2, 
y = games.screen.height/2, 
dx = 1, 
dy = 1) 

games.screen.add(the_pizza) 

games.screen.mainioop() 

# kick it off! 
main() 

YouVe seen the bulk of this code before. One important difference is that I created an ohject 
from my new Pizza class instead of Sprite. Because of this, the objecfs updateO method 
checks for screen boundaries and reverses the velocities when necessary for a pizza that 
bounces! 

Handling Mouse Input 

Although you’ve seen a lot of what the 1 i vewi res package has to offer, you haven’t seen the 
main ingredient of interactivity: user input. One of the most common ways to get input from 
a user is through the mouse. 1 i vewi res offers an object to let you do just that. 
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Introducing the Moving Pan Program 

The mouse object from the games module gives you access to the mouse. The object has prop- 
erties that make reading the mouse position on the graphics screen a piece of cake. With these 
properties, I create the Moving Pan program that allows a user to drag a pan sprite across the 
screen as he or she moves the mouse. The results of the program are displayed in Figure 11.13. 


Q Figure 11.13 ^ 

The pan sprite 
foLLows the mouse 
around the 
graphics screen. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 11 folder; the file name is moving_pan.py. 

Setting Up the Program 

The following code should look remarkably familiar; 

# Moving Pan 

# Demonstrates mouse input 
from livewires import games 

games.init(screen_width = 640, screen_height = 480, fps = 50) 
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As before, I import gatnes and initialize the graphics screen. The initO also creates the 
mouse object ITl use to read the mouse position. 

Reading Mouse x- and y-coordinates 

Next, I create Pan for the pan sprite: 

class Pan(ganies.Sprite): 

. A pan controlled by the mouse. . 

def update(self): 

. Move to mouse coordinates. . 

self.x = games.mouse.X 
self.y = games.mouse.y 

Like a Spri te object, the mouse object has an x property for its x-coordinate and a y property 
for its y-coordinate. With them, I can read the current mouse location on the graphics screen. 

In the update( ) method, I assign the Pan ohjecfs x property the value of the mouse ohjecfs x 
property. Then I assign the Pan ohjecfs y property the value of the mouse ohjecfs y property. 
This moves the pan to the current location of the mouse pointer. 

Next, I write a ma i n ( ) function that contains the type of code you’ve seen hefore that sets the 
hackground image and creates sprite objects: 

def main(): 

wall_image = games.load_image("wall.jpg", transparent = False) 
games.screen.background = wall_image 

pan_image = games.load_image("pan.bmp") 
the_pan = Pandmage = pan_image, 
x = games.mouse.x, 
y = games.mouse.y) 
games.screen.add(the_pan) 

By passing games .mouse.x to x and games .mouse .y to y, the Pan ohject starts off at the mouse 
coordinates. 

Setting Mouse Pointer Visibility 

Next in mai n(), I use the mouse ohjecfs i s_vi si bl e property to set the visibility of the mouse 
pointer. 

games.mouse.is_visible = False 
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Setting the property to True means the mouse pointer will be visible, while setting it to 
Fal se means the pointer will not be visible. Since 1 don’t want the pointer sitting on top of 
the pan image, 1 set the property to False. 

Grabbing Input to the Graphics Window 

Next in main( ), 1 use the screen objecfs event_grab property to grab all of the input to the 
graphics screen: 

games.screen.event_grab = True 

Setting the property to True means that all input will be focused on the graphics screen. The 
benefit of this is that the mouse won’t leave the graphics window. Setting the property to 
False means that all input is not focused on the graphics screen and that the mouse pointer 
can leave the graphics window. 

If you grab aLL of the input to the graphics screen, you won't be abLe to cLose the 
graphics window with the mouse. However, you can aLways cLose the window by 
pressingthe Escape key. 



Wrapping up the Program 

Finally, 1 wrap up mainO as before and invoke mainloopO to make sure everything on the 
screen is updated. 

games.screen.mainloop() 

# kick it off! 
maini) 

Check out Table 11.9 for a summary of a few useful mouse properties. 



Table 11.9 Useful 

MOUSE Properties ^ 

f - 

Property 

Descriptiori 

-\ 

X 

x-coordinate of mouse pointer. 


y 

y-coordinate of mouse pointer. 


is_visible 

Boolean value for setting visibility of 
visible. Default value is True. 

mouse pointer. True is visible while Fal se is not 
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Detecting Collisions 

In most games, when two things collide, there’s a ciear resuit. It can be as simple as a 2D 
character running into a boundary that won’t let him pass, or as spectacular as a 3D scene 
where an asteroid tears through the hull of a massive mother ship. Either way, there’s a need 
to detect when objects collide. 

Introducing the SUppery Pizza Program 

The Slippery Pizza program is an extension of the Moving Pan program. In the Slippery Pizza 
program, the user Controls a pan with the mouse, just like in the Moving Pan program. This 
time, however, there’s a pizza sprite on the screen. The user can move the pan toward the 
pizza, but as soon as he or she reaches it, the slippery pizza moves to a new, random screen 
location. Figures 11.14 and 11.15 show the program in aedon. 
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Q Figure 11.15 ^ 

The sLIppery pizza 
gets away again. 



You can find the code for the program on the companion website (www.courseptr.com/down- 
loads) in the Chapter 11 folder; the file name is slippery_pizza.py. 

Setting Up the Program 

The initial code is taken from the Moving Pan program, with one minor addition: 

# Slippery Pizza Program 

# Demonstrates testing for sprite collisions 

from livewires import games 
import random 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

The one new thing I do is import our old friend the random module. This allows me to generate 
a new, random location for the pizza sprite after the collision. 

Detecting Collisions 

1 create a new Pan class hy adding some code for the collision detection: 
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class Pan(ganies.Sprite): 

. A pan controlled by the mouse. . 

def update(self): 

. Move to mouse position. . 

self.x = games.mouse.X 
self.y = games.mouse.y 
self.check_col1ide() 

def check_col1ide(self): 

. Check for coli i sion with pizza. . 

for pizza in self.overlapping_sprites: 
pizza.handle_collide() 

In the last line of update(), I invoke the Pan method check_col 1 ide(). The check_col 1 ide() 
method loops throughthe Pan ohjecfs overl appi ng_spri tes property—a list of ali oftheobjects 
that overlap it. Each object that overlaps the pan has its handl e_col 1 ide() method called. 
Basically, the pan is telling any object that overlaps it to handle the collision. 

Handling ColUsions 

Next, I create a new Pizza class: 

class Pizza(games.Sprite): 

. A slippery pizza. . 

def handle_collide(self): 

. Move to a random screen location. . 

self.x = random.randrange(games.screen.width) 
self.y = random.randrange(games.screen.height) 

I write just one method, handl e_col 1 i de 0, which generates random screen coordinates and 
moves the Pizza object to this new location. 

Wrapping Up the Program 

Here’s the mai n() function: 
def main(): 

wall_image = games.load_image("wall.jpg", transparent = False) 
games.screen.background = wall_image 

pizza_image = games.load_image("pizza.bmp'') 
pizza_x = random.randrange(games.screen.width) 
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pizza _y = random.randrange(ganies.screen.height) 

the_pizza = Pizzadmage = pizza_iniage, x = pizza_x, y = pizza_y) 

games.screen.add(the_pizza) 

pan_image = games.load_image("pan.bmp'') 
the_pan = Pandmage = pan_image, 

X = games.mouse.x, 
y = games.mouse.y) 
games.screen.add(the_pan) 

games.mouse.is_visible = False 

games.screen.event_grab = True 

games.screen.mainloop() 

# kick it off! 
main() 

As always, I set a background image. Then, I create two objects: a Pi zza object and a Pan object. 
I generate a random set of screen coordinates for the pizza and place the pan at the mouse 
coordinates. I set the mouse pointer to invisible and grah ali input to the game window. Then, 
1 invoke ma i n 1 oop (). Finally, 1 kick everything off by calling mai n (). 

Back to THE Pizza Panic Game 

Now that you’ve gotten a taste of what the 1 i vewi res multimedia package can do, it’s time to 
create the Pizza Panic game introduced at the heginning of the chapter. Much of the code for 
the game can be taken directly from the example programs. However, FU also introduce a 
few new concepts. You can find the code for the program on the companion website 
(www.courseptr.com/downloads) in the Chapter 11 folder; the file name is pizza_panic.py. 

Setting Up the Program 

As in all of the programs in this chapter, 1 begin by importing modules and initializing the 
graphics screen: 

# Pizza Panic 

# Player must catch falling pizzas before they hit the ground 
from 1 ivewires import games, color 
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import random 

gaines.init(screen_width = 640, screen_height = 480, fps = 50) 

To do any graphics work, I need to import games, while color gives me access to the set of 
predefined colors. I import random so that the crazy chef seems more life-like when he makes 
his choices. Finally, I call games init( ) to initialize the graphics screen and to give me access 
to the games mouse object. 

The Pan CLass 

The Pan class is ablueprint for the pan sprite that the player Controls with the mouse. However, 
the pan will only move left and right. ITl go through the class, one section at a time. 

Loadingthe Pan Image 

1 do something a little different in the beginning of this class: 1 load a sprite image and assign 
it to a class variable, image. 1 do this because Pizza Panic has several classes, and loading an 
image in its corresponding class definition is cleaner than loading all of the images in the 
program’s main () function. 

class Pan(games.Sprite): 

II II II 

A pan controlled by player to catch falling pizzas. 

II II II 

image = games.load_image(''pan.bmp") 

The _init_{) Method 

Next, 1 write the constructor to initialize a new Pan object: 
def _init_(self): 

. Initialize Pan object and create Text object for score. . 

super(Pan, self)._init_(image = Pan.image, 

X = games.mouse.X, 

bottom = games.screen.height) 

self.score = games.Text(value = 0, size = 25, color = color.black, 

top = 5, right = games.screen.width - 10) 
games.screen.add(self.score) 
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I use the super( ) function to make sure that the Spri te i ni 10 method is called. Then, I define 
an attribute score— a Text object—for the player’s score, whichbegins at 0. Of course, I remem- 
ber to add the new Text object to the screen so it’s displayed. 

The updateO Method 

This method moves the player’s pan: 

def update(self): 

. Move to mouse x position. . 

self.x = games.mouse.X 

if self.left < 0: 
self.left = 0 

if self.right > games.screen.width: 
self.right = games.screen.width 

self.check_catch() 

The method assigns the mouse x-coordinate to the Pan objecfs x-coordinate, allowing the 
player to move the pan left and right with the mouse. 

Next, I use the objecfs 1 eft property to check if its left edge is less than 0— meaning that part 
of the pan is beyond the left edge of the graphics window. If it is, 1 set the left edge to 0 so 
that the pan is displayed at the left edge of the window. 

Then, 1 use the objecfs right property to check if its right edge is greater than 
games. screen .wi dth— meaning that part of the pan is beyond the right edge of the graphics 
window. If it is, 1 set the right edge to games. screen .wi dth so that the pan is displayed at the 
right edge of the window. 

Finally, 1 invoke the objecfs check_catch() method. 

The check_catch{) Method 

This method checks if the player has caught any of the falling pizzas: 

def check_catch(self): 

. Check if catch pizzas. . 

for pizza in self.overlapping_sprites: 
self.score.value += 10 
self.score.right = games.screen.width - 10 
pizza.handle_caught() 
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For each object that overlaps the pan, the method increases the player’s score by 10. Then it 
ensures that the right edge of the Text object for the score is always 10 pixels from the right 
edge of the screen, no matter how many digits long the score gets. Lastly, the method invokes 
the handl e_caught( ) method of the overlapping sprite. 

The Pizza Class 

This class is for the falling pizzas that the player must catch: 
class Pizza(games.Sprite): 

II II II 

A pizza which falis to the ground. 

II II II 

image = games.load_iniage("pizza.bmp'') 
speed = 1 

I define two class variables: image for the pizza image and speed for the pizzas’ falling speed. 
1 set speed to 1 so that the pizzas fall at a fairly slow speed. 1 use both class variables in the 
Pi zza constructor method, as you’ll soon see. 

The _init_{) Method 

This method initializes a new Pizza ohject: 

def _init_(self, x, y = 90): 

. Initialize a Pizza object. . 

superiPizza, self)._init_(image = Pizza.image, 

X = X, y = y, 
dy = Pizza.speed) 

All 1 do in this method is call the constructor of the super class of Pi zza. Note that 1 set the 
default value for y to 90, which puts each new pizza right at the chef s chest level. 

The updateO Method 

This method handles screen houndary checking: 

def update(self): 

. Check if bottom edge has reached screen bottom. . 

if self.bottom > games.screen.height: 
self.end_game() 
self.destroy() 
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All this method does is check if a pizza has reached the hottom of the screen. If it has, the 
method invokes the ohjecfs end_ganie( ) method and then the object removes itself from the 
screen. 


The handLe_caught() Method 

Remember, this method is invoked by the Pan object when the Pizza object collides with it: 

def handle_caught(self): 

. Destroy self if caught. . 

self.destroyO 

When a pizza collides with a pan, the pizza is considered “caught” and simply ceases to exist. 
So, the Pi zza object invokes its own destroy( ) method and the pizza literally disappears. 


The end_game{) Method 

This method ends the game. lt’s invoked when a pizza reaches the hottom of the screen. 

def end_game(self): 

. End the game. . 

end_message = games.Message(value = "Game Over", 

size = 90, 
color = color.red, 

X = games.screen.width/2, 
y = games.screen.height/2, 
lifetime = 5 * games.screen.fps, 
after_death = games.screen.quit) 
games.screen.add(end_message) 

The code creates a Message object that declares that the game is over. After about five seconds, 
the message disappears and the graphics window closes, ending the game. 



The end_game( ) method is caLLed whenever a pizza reaches the hottom of the 
screen. However, since the "Game Over" message Lasts about five seconds, it's 
possibLe for another pizza to reach the bottom of the screen before the graphics 
window cLoses—resuLting in multiple "Game Over” messages. 

In Chapter I 2, you'll see how to create an object to represent the game itself, 
whichcould keeptrackof whetheror notthegameis over and preventsomething 
like multiple "Game Over” messages from being created. 


The Chef CLass 

The Chef class is used to create the crazy chefwho throws the pizzas off the restaurant rooftop. 
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class Chef(games.Sprite): 

H II II 

A chef which moves left and right, dropping pizzas. 

II II II 

image = games.load_image(''chef .bmp") 

I define a class attribute, i mage, for the chef image. 

The _init_() Method 

Here’s the constructor method: 

def _init_(self, y = 55, speed = 2, odds_change = 200): 

. Initialize the Chef object. . 

super(Chef, self)._init_(image = Chef.image, 

X = games.screen.width / 2, 

y = y. 

dx = speed) 

self.odds_change = odds_change 
self.time_til_drop = 0 

First, I call the constructor of the super class of Chef. 1 pass image the class attribute 
Chef. image. 1 pass x a value that puts the chef right in the middle of the screen. For y, the 
default value of 55 puts the chef right on top of the brick wall. dx is passed speed, which 
determines the chefs horizontal velocity as he moves along the rooftop. The default 
value is 2. 

The method also creates two object attributes: odds_change and time_ti l_drop. odds_change is 
an integer that represents the odds that the chef will change his direction. For example, if 
odds_change is 200, then there’s a 1 in 200 chance that every time the chef moves, heTl reverse 
direction. YouTl see how this works in the updatel ) method of the class. 

time_ti l_drop is an integer that represents the amount oftime, in mai nl oop( ) cycles, until the 
chef drops his next pizza. 1 set it to 0 initially, meaning that when a Chef object springs to life, 
it should immediately drop a pizza. YouTl see how time_ti l_drop works in the check_drop() 
method. 

The updateO Method 

This method defines the rules for how the chef decides to slide back and forth along the 
rooftop: 
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def update(self): 

. Determine if direction needs to be reversed. . 

if self.left < 0 or self.right > games.screen.width: 
seif.dx = -self.dx 

elif random.randrange(self.odds_change) == 0: 
self.dx = -self.dx 

self.check_drop() 

A chef slides along the rooftop in one direction until he either reaches the edge of the screen 
or “decides,” at random, to switch directions. The heginning of this method checks to see if 
the chef has moved heyond the left or right edge of the graphics window. If he has, then he 
reverses direction with the code self.dx = -self.dx. Otherwise, the chef has a 1 in 
odds_change chance of changing direction. 

Regardless of whether or not the chef changes direction, the last thing the method does is 
invoke the Chef ohjecfs check_drop( ) method. 

The check_drop{) Method 

This method is invoked every mai n 1 oop ( ) cycle, hut that doesnT mean a new pizza is dropped 
50 times a second! 

def check_drop(self): 

. Decrease countdown or drop pizza and reset countdown. . 

if self.time_til_drop > 0: 

self.time_til_drop -= 1 
el se: 

new_pizza = Pizzaix = self.x) 
ganies.screen.add(new_pizza) 

# set buffer to approx 30% of pizza height, regardless of pizza speed 
self.time_til_drop = int(new_pizza.height * 1.3 / Pizza.speed) -i- 1 

tinie_ti l_drop represents a countdown for our chef. If time_ti l_drop is greater than 0, then 
1 is suhtracted from it. Otherwise, a new Pi zza ohject is created and time_ti l_drop is reset. 

In creating a new pizza, I pass the Chef ohjecfs x-coordinate to the Pi zza constructor so that 
the new pizza sprite hegins at the same location as the chef sprite. 
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The new value of tinie_ti l_drop is calculated so that the next pizza will be dropped when the 
distance from the previous one is about 30% of the pizza height, independent of how fast the 
pizzas are falling. 

The main() Function 

The niain( ) function creates objects and starts up the game: 
def niain(): 

. Play the game. . 

wall_image = gatiies.load_image("wall. jpg", transparent = False) 
games.screen.background = wall_image 

the_chef = Chef() 
games.screen.add(the_chef) 

the_pan = Pan() 
games.screen.add(the_pan) 

games.mouse.is_visible = False 

games.screen.event_grab = True 
games.screen.mainloop() 

# start it up! 
main() 

First, I set the brick wall as the background. I create a chef and a pan. Then, I set the mouse 
pointer to invisible and grab all of the input so the mouse pointer can’t leave the graphics 
window. I invoke ma i n 1 oop () to begin the game. Finally, I call ma i n ( ) to Idck it all offl 

SUMMARY 

In this chapter, you saw how to use the 1 i vewi res multimedia package to add graphics to your 
programs. You learned how to create a new graphics window and how to set a background 
image for it. You saw how to display text on a graphics window. You learned about the sprite, 
a special graphics object with an image. Specifically, you saw how to place and move a sprite 
on a graphics screen. You also saw how to test for collisions between sprites. You learned how 
to get input from the mouse. Finally, you saw how to put everything together in a fast-paced 
video game, complete with a computer-controlled opponent. 
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Challenges 

1. Improve the Pizza Panicgame by increasingits difficulty as the 
game progresses. Think of different ways to accomplish this. 

You could increase the speed of the pizzas and the speed of the 
chef. You could raise the player's pan to a higher position on 
the screen. You could even increase the number of crazy chefs 
flinging pizzas. 

2. Write a game where the player Controls a character that must 
avoid falling debris. The player Controls the character with the 
mouse and objects fall from the sky. 

3. Create a simple, one-player game of pong, where a player 
Controls a paddle and the ball bounces off three walls. If the 
ball gets by the player's paddle, the game is over. 
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SoUND, Animation, and 
Program Development: 
The Astrocrash Game 


I n this chapter, you’ll expand your multimedia programming skills to 
include sound and moving images. You’11 also see how to write a large 
program in stages. Specifically, you’11 learn to do the following: 

• Read the keyboard 
• Play sound files 
• Play music files 
• Creafe animafions 

• Develop a program by wrifing progressively more complete versions of it 

Introducing THE Astrocrash Game 

The proj ect for this chapter, the Astrocrash game, is my version of the classic arcade 
game Asteroids. In Astrocrash, the player Controls a ship in a moving field of deadly 
asteroids. The ship can rotate and thrust forward—most importantly, though, it 
can fire missiles at the asteroids to destroy them. The player, however, has some 
Work cut out for him or her as large- and medium sized asteroids break apart into 
two smaller asteroids when destroyed. And just when the player manages to oblit- 
erate all of the asteroids, a new, larger wave appears. The player’s score increases 
with every asteroid he or she destroys, but once the player’s ship collides with a 
floating space rock, the game is over. Figures 12.1 and 12.2 show the game in action. 
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Q Figureiz.i ^ 

The pLayer 
Controls a 
spaceship and 
bLasts asteroids to 
increase his or her 
score. (NebuLa 
image is in the 
pubLic domain. 
Credit: NASA, The 
HubbLe Heritage 
Team-AURA/ 
STSci) 



Q FiGURE 12.2 ^ 

If an asteroid hits 
the pLayer's ship, 
the game is over. 
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ReADING THE KeYBOARD 

You already Icnow how to get strings from the user through the i nput () function, but reading 
the keyboard for individual keystrokes is another matter. Fortunately, there’s a new object 
from the games module that lets you do just this. 

Introducing the Read Key Program 

The Read Key program displays the ship on the nebula background. The user can move the 
ship around with different keystrokes. When the user presses the W key, the ship moves up. 
When the user presses the S key, the ship moves down. When the user presses the A key, the 
ship moves left. When the user presses the D key, the ship moves right. The user can also press 
multiple keys simultaneously for a combined effect. For example, when the user presses the 
W and D keys simultaneously, the ship moves diagonally, up and to the right. The program 
is illustrated in Figure 12.3. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is read_key.py. 
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Setting Up the Program 

As I do with ali programs that use the 1 i vewi res package, 1 start by importing the modules 1 
need and calling the initialization method: 

# Read Key 

# Demonstrates reading the keyboard 
from 1 ivewires import games 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

Testlng for Keystrokes 

Next, 1 write a class for the ship. In the update( ) method, 1 check for keystrokes and change 
the position of the ship accordingly. 

class Ship(ganies.Sprite): 

. A moving ship. . 

def update(self): 

. Move ship based on keys pressed. . 

if games.keyboard.is_pressed(games.K_w): 
self.y -= 1 

if games.keyboard.is_pressed(ganies.K_s): 
self.y += 1 

if games.keyboard.is_pressed(games.K_a): 
self.x -= 1 

if games.keyboard.is_pressed(games.K_d): 
self.x += 1 

luse the new keyboard object from the games module. You canuse the object to test for specific 
keypresses. 1 invoke the objecfs i s_pressed( ) method, which returns True if the key being 
tested for is pressed, and Fal se if not. 

1 use the i s_pressed ( ) method in a series of i f statements to test if any of the four keys—W, 
S, A, or D—is being pressed. If the W key is pressed, 1 decrease the objecfs y property by 1, 
moving the sprite up the screen by one pixel. If the S key is pressed, 1 increase the objecfs y 
property by 1 , moving the sprite down the screen. If the A key is pressed, 1 decrease the obj ecf s 
X property by 1, moving the sprite left. If the D key is pressed, 1 increase the objecfs x property 
by 1, moving the sprite right. 
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Since multiple calls to is_pressed() can read simultaneous keypresses, the user can hold 
down multiple keys for a combined effect. For example, if a user holds down the D and S keys 
at the same time, the ship moves down and to the right because each time update ( ) executes, 
the Shi p ohject adds one to its x-coordinate and one to its y-coordinate. 

The games module has a set of constants that represent keys that you can use as an argument 
in i s_pressed () . In this program, 1 use the games. K_w constant for the Wkey; games. K_s for the 
S key; games. K_a for the A key; and games. K_d for the D key. The naming of these constants is 
pretty intuitive. Here’s a quick way to figure out the name of most key constants: 

• All keyboard constants begin with games. K_. 

• For alphabetic keys, add the key letter, in lowercase, to the end of the constant name. 
For example, the constant for the A key is games. K_a. 

• For numeric keys, add the key number to the end of the constant name. For example, 
the constant for the 1 key is games. K_l. 

• For other keys, you can often add their name, in all capital letters, to the end of the 
constant name. For example, the constant for the spacebar is games. K_SPACE. 

For a complete list of keyboard constants, see the 1 i vewi res documentation in Appendix B. 

Wrapping Up the Program 

Finally, 1 write the familiar main( ) function. 1 load the nebula background image, create a 
ship in the middle of the screen, and kick everything off hy invoking mai nl oop(). 

def main(): 

nebula_image = games.load_image("nebula.jpg", transparent = False) 
games.screen.background = nebula_image 

ship_image = games.load_image("ship.bmp") 
the_ship = Shipdmage = ship_image, 

X = games.screen.width/2, 
y = games.screen.height/2) 
games.screen.add(the_ship) 

games.screen.mainloop() 


main() 
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Rotating a Sprite 

In Chapter 11, you learned how to move sprites around the screen, but 1 ivewi res lets you 
rotate them as well. You rotate a sprite through one of its properties. 


Introducing the Rotate Sprite Program 

In the Rotate Sprite program, the user can rotate the spacecraft using the keyboard. If the 
User presses the right arrow key, the ship rotates clockwise. If the user presses the left arrow 
key, the ship rotates counterclockwise. If the user presses the 1 key, the ship jumps to a rota- 
tion of 0 degrees. If the user presses the 2 key, the ship jumps to a rotation of 90 degrees. If 
the user presses the 3 key, the ship jumps to a rotation of 180 degrees. If the user presses the 
4 key, the ship jumps to a rotation of 270 degrees. Figure 12.4 displays the program. 



The Rotate Sprite program checks for keypresses of the numeric keys above the 
Letter keys on the keyboard, not the numeric keys on the keypad. 


Q Figure 12.4 ^ 

Theshipcan rotate 
cLockwise, rotate 
countercLockwise, 
or jump to a 
predetermined 
angLe. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is rotate_sprite.py. 
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# Rotate Sprite 

# Demonstrates rotating a sprite 
frotn livewires import games 

ganies.init(screen_width = 640, screen_height = 480, fps = 50) 

class Ship(games.Sprite): 

. A rotating ship. . 

def update(self): 

. Rotate based on keys pressed. . 

if games.keyboard.is_pres sed(games.K_RIGHT): 
self.angle += 1 

if games.keyboard.is_pressed(games.K_LEFT): 
self.angle -= 1 

if games.keyboard.is_pressed(games.K_l): 
self.angle = 0 

if games.keyboard.is_pressed(games.K_2): 
self.angle = 90 

if games.keyboard.is_pressed(games.K_3): 
self.angle = 180 

if games.keyboard.is_pressed(games.K_4): 
self.angle = 270 

def main(): 

nebula_image = games.load_image("nebula.jpg", transparent = False) 
games.screen.background = nebula_image 

ship_image = games.load_image("ship.bmp") 
the_ship = Shipdmage = ship_image, 

X = games.screen.width/2, 
y = games.screen.height/2) 
games.screen.add(the_ship) 

games.screen.mainioop() 


main() 
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Using a Sprite's angle Property 

The newelement in the program is the angle property, which represents a sprite’s facing in 
degrees. You can add to or subtract from the property, or you can simply assign a new value 
to it to change the facing of a sprite. 

In the update () method, I first check if the right arrow key is pressed. If it is, I add one to the 
objecfs angi e property, which rotates the sprite by one degree cloclcwise. Next, I check if the 
left arrow key is pressed. If it is, I subtract one from the property, rotating the sprite one 
degree counterclockwise. 

The next set of lines rotates the ship directiy to a specific angle by assigning a new value to 
the angle property. When the user presses the 1 key, the code assigns 0 to angi e and the sprite 
jumps to a rotation of 0 degrees (its starting orientation). When the user presses the 2 key, 
the code assigns 90 to angi e and the sprite jumps to a rotation of 90 degrees. When the user 
presses the 3 key, the code assigns 180 to angle and the sprite jumps to a rotation of 180 
degrees. Finally, when the user presses the 4 key, the code assigns 270 to angi e and the sprite 
jumps to a rotation of 270 degrees. 

Creating an Animation 

Moving and rotating sprites adds excitement to a game, but animation really makes a game 
come to life. Fortunately, the gatnes module contains a class for animations, aptly named 
Animation. 

Introducing the Explosion Program 

The Explosion program creates an explosion animation in the middle of a graphics screen. 
The animation plays continuously so that you can get a good look at it. When you’re done 
appreciating the cool effect, you can end the program by closing the graphics window. Figure 
12.5 shows a snapshot of the program in aedon. 
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Examining the Explosion Images 

An animation is a sequence of images (also called/rames) displayed in succession. I created a 
sequence of nine images that, when displayed in succession, resembles a fieiy explosion. 
Figure 12.6 displays ali nine images. 

You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is explosion.py. 
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Q Figure 12.6 ^ 

Shown In rapld 
succession, these 
nine frames Look 
Like an expLosion. 



Setting Up the Program 

As always, the initial code imports the modules I need and calls the initialization method: 

# Explosion 

# Demonstrates creating an animation 
from livewires import games 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

Then, I set the hackground of the graphics screen: 

nebula_iniage = games.load_iniage( "nebul a. jpg", transparent = 0) 
games.screen.background = nebula_image 

Creating a List of Image Files 

The constructor ofthe Animati on class takes alist of image file names or a listof image objects 
for the sequence of images to display. So, next, 1 create a list of image file names, which 
corresponds to the images shown in Figure 12.6; 
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Creating an Animation Object 

Finally, I create an Ani mati on object and add it to the screen: 

explosion = games.Animation(images = explosion_files, 

X = games.screen.width/2, 
y = games.screen.height/2, 
n_repeats = 0, 
repeat_interval = 5) 

games.screen.add(explosion) 

The Animati on class is derived from Spri te, so it inherits ali of Spri te’s attributes, properties, 
and methods. Like ali sprites, you can supply x- and y-coordinates to define where an anima¬ 
tion will be located. In the previous code, I supply coordinates to the class constructor so that 
the animation is created at the center of the screen. 

An animation is different from a sprite in that it has a list of images that it cycles through. 
So, you must supply a list of image file names as strings or a list of image objects for the 
images to be displayed. I supply a list of strings for the image file names, expl osi on_f i 1 es, to 
images. 

An objecfs n_repeats attribute represents how many times the animation (as a sequence of 
all of its images) is displayed. A value of 0 means that the animation will loop forever. The 
default value of n_repeats is 0. Since I pass 0 to n_repeats, the explosion animation will cycle 
forever (or at least until you close the graphics window). 

An objecfs repeat_interval attribute represents the delay between successive images. A 
higher number means a longer delay between frames, resulting in a slower animation. A 
lower number represents a shorter delay, producing a faster animation. I pass repeat_inter¬ 
val the value 5 to get the speed I think is right for a convincing explosion. 

Last but not least, I kick off the program by involdng the screen objecfs mai nl oop( ) method: 
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ganies.screen.mainloop() 

WORKING WITH SOUND AND MuSIC 

Sound and music add another sensory dimension to your programs. Loading, playing, loop- 
ing, and stopping sound and music are easy to do with the games module. While people might 
argue about the difference between sound and music, there’s no such argument when it 
comes to 1 i vewi res, where there’s a ciear distinction between the two. 

Introducing the Sound and Music Program 

The Sound and Music program allows the user to play, loop, and stop the missile sound effect 
and the theme music from the Astrocrash game. The user can even play both at the same 
time. Figure 12.7 shows the program running (but, unfortunately, doesnT make a sound). 


Q Figure 12.7 ^ 

The program Lets 
the user pLay a 
sound and some 
music. 


|C:\Python22\python.exe 


Sound and tlusic 
0 — Quit 

1 — Play missile sound 

2 - Loop missile sound 

3 - Stop missile sound 

4 - Play theme music 

5 - Loop theme music 

6 - Stop theme music 


HEID 



Whenyou run the program,you’LLwanttointeract with the consoLe window. You 
shouLd position the consoLe window so that it's not hidden by the graphics win¬ 
dow. You can ignore or even minimize the graphics window created by the 
program. 


You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is sound_and_music.py. 
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Working with Sounds 

You can create a sound object for use in a program by loading a WAV file. The WAV format 
is great for sound effects because it can be used to encode whatever you record with a 
microphone. 

Loading a Sound 

First, I set up the program as always: 

# Sound and Music 

# Demonstrates playing sound and music files 
from livewires import games 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

Then, I load a WAV file by using the games function 1 oad_sound(). 

# load a sound file 

missile_sound = games.load_sound(''missile.wav'') 

The function takes a string for the name of the sound file to he loaded. 1 load the file 
missi 1 e.wav and assign the resulting sound ohject to missi 1 e. 

A-** You can onLy Load WAV files with the 1 oad_sound() function. 



Next, 1 load the music file: 

# load the music file 
games.music.loadCtheme.mid") 

ITl save the music discussion until after 1 finish demonstrating sounds. 

Playing a Sound 

Next, 1 write the menu system that you first saw in Chapter 5: 

choice = None 
while choice != "0": 


print( 
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II II II 

Sound and Music 


0 - Quit 

1 - Play missile sound 

2 - Loop missile sound 

3 - Stop missile sound 

4 - P1ay theme music 

5 - Loop theme music 

6 - Stop theme music 

II II II 

) 


choice = input("Choice: ") 
print() 

# exit 

if choice == "0": 

printCGood-bye.") 

If the User enters 0, the program says good-hye and then exits. 

The following code handles the case where a user enters 1: 

# play missi1 e sound 
elif choice == "1": 

missile_sound.play() 

print("Playing missile sound.") 

To play the sound once, I invoke the sound objecfs pl ay() method. When a sound plays, it 
takes up one of the eight available sound channels. To play a sound, you need at least one 
open sound channel. Once all eight sound channels are in use, involdng a sound objecfs 
pl ay () method has no effect. 

Ifyou invoke the pl ay() method of a sound object thaf s already playing, the sound will start 
playing on another sound channel, if one is available. 

Looping a Sound 

You can loop a sound by passing the number of additional times you want the sound played 
to the objecfs pl ay( ) method. For example, ifyou pass 3 to pl ay(), the corresponding sound 
will play four times (its initial playing plus three additional times). You can loop a sound 
forever by passing -1 to pl ay (). 
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The following code handles the case when a user enters 2: 

# loop missile sound 
elif choice == "2": 

loop = int(input("Loop how many extra times? (-1 = forever): ")) 

missile_sound.play(loop) 

printCLooping missile sound.") 

In this section of code, I get the numher of additional times the user wants to hear the missile 
sound and then I pass that value to the sound objecfs pl ay( ) method. 

Stopping a Sound 

You stop a sound object from pla 5 dng by involdng its stop () method. This stops the particular 
sound on ali channels that it’s playing. If you invoke the stop( ) method of a sound object 
thafs not currently pla 5 dng, youTl find 1 i vewi res is forgiving and won’t complain with an 
error. 

If the user enters 3, the following code stops the missile sound (if it’s playing): 

# stop missile sound 
elif choice == "3": 

missile_sound.stop() 
printCStopping missile sound.") 

Working with Music 

In 1 i vewi res , music is handled somewhat differently than sound. First, there is only one music 
channel, so only one file can be designated as the current music file at any given time. How- 
ever, the music channel is more flexible than the sound channels. The music channel accepts 
many different t 5 rpes of sound files, including WAV, MP3, OGG, and MIDI. Finally, since there 
is only one music channel, you don’t create a new object for each music file. Instead, you 
access a set of functions to load, play, and stop music. 

Loading Music 

You saw the code for loading the music file in the section “Loading a Sound.” The code accesses 
music from games. It’s through music thatyou’re able to load, play, and stop the single music 
track. 

The codelused to load the music track, games .musi c . 1 oad( "theme.mid" ), sets the current music 
to the MIDI file theme.mid. You load a music file by calling the games .musi c. 1 oad( ) function 
and passing it the music file name as a string. 
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You have only one available music track. So, ifyou load a new music file, it replaces the current 
one. 

PLaying Music 

The following code handles the case where the user enters 4: 

# play theme music 
elif choice == "4" : 

games.music.playO 

print("P1aying theme music.") 

As a resuit, the computer plays the music file that I loaded, theme.mi d. If you don’t pass any 
values to games .musi c.pl ay( ), the music plays once. 

Looping Music 

You can loop the music hy passing the number of additional times you want the music played 
to pl ay( ). For example, ifyou pass 3 to games .musi c. pl ay ( ), the music will play four times (its 
initial playing plus an additional three times). You can loop a music file forever by passing - 
1 to the function. 

The following code handles the case when a user enters 5: 

# loop theme music 
elif choice == "5" : 

loop = int(input("Loop how many extra times? (-1 = forever): ")) 
games.music.play(loop) 
printCLooping theme music.") 

In this section of code, I get the numher of additional times the user wants to hear the theme 
music and then I pass that value to pl ay (). 

Stopping Music 

If the user enters 6, the following code stops the music (if it’s pla 5 dng): 

# stop theme music 
elif choice == "6": 

games.music.stopO 

print("Stopping theme music.") 

You can stop the current music from playing hy calling games .music. stop(), which is what I 
do here. If you call the function while there is no music playing, 1 i vewi res is forgiving and 
won’t complain with an error. 
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Wrapping Up the Program 

Finally, I wrap up the program by handling an invalid choice and waiting for the user: 

# some unknown choice 
else: 

print("\nSorry, but", choice, ''isn't a valid choice.") 
input(''\n\nPress the enter key to exit.") 

Planning THE Astrocrash Game 

It’s time to return to the chapter project: the Astrocrash game. I plan to write progressively 
more complete versions of the game until it’s done, but I stili feel 1 need to list a few details 
of the program, including the game’s major features, a few necessary classes, and the multi- 
media assets required. 

Game Features 

Although my game is based on a classic video game that 1 know well (and learned about the 
hard way, one quarter at a time), it’s stili a good idea to write out a list of features: 

• The ship should rotate and thrust forward based on keystrokes from the player. 

• The ship should fire missiles based on a keystroke from the player. 

• Asteroids should float at different velocities on the screen. Smaller asteroids should 
generally have higher velocities than larger ones. 

• The ship, any missiles, and any asteroids should “wrap around” the screen—if they move 
beyond a screen boundary, they should appear at the opposite boundary. 

• If a missile hits another object on the screen, it should destroy the other object and itself 
in a nice, fiery explosion. 

• If the ship hits any other object on the screen, it should destroy the other object and 
itself in a nice, fiery explosion. 

• If the ship is destroyed, the game is over. 

• If a large asteroid is destroyed, two new medium-sized asteroids should be produced. If 
a medium-sized asteroid is destroyed, two new small asteroids should be produced. If a 
small asteroid is destroyed, no new asteroids should be produced. 

• Every time a player destroys an asteroid, his or her score should increase. Smaller aster¬ 
oids should be worth more points than larger ones. 

• The player’s score should be displayed in the upper-right corner of the screen. 

• Once all of the asteroids have been destroyed, a new, larger wave of asteroids should be 
created. 
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I leave out a few features of the original to keep the game simple. 

Game Classes 

Next, I make a list of the classes that 1 think 1 need: 

• Ship 

• Missile 

• Asteroid 

• Explosion 

1 Icnow a few things about these classes already. Ship, Mi ssi 1 e, and Asteroid will be derived 
from games.Sprite, while Explosion will be derived from games.Animation. 1 also know that 
this list could change as 1 put theory into practice and code the game. 

Game Assets 

Since the game includes sound, music, sprites, and animation, 1 know 1 need to create some 
multimedia files. Here’s the list 1 came up with: 

• An image file for the ship 

• An image file for the missiles 

• Three image files, one for each size of asteroid 

• A series of image files for an explosion 

• A sound file for the thrusting of the ship 

• A sound file for the firing of a missile 

• A sound file for the explosion of an object 

• A music file for the theme 

Creating Asteroids 

Since the game involves deadly asteroids, 1 thought Fd start with them. Although this seems 
like the best first step to me, it may not to another programmer—and thafs fine. You could 
certainly start with a different first step, such as getting the player’s ship on the screen. There’s 
no one right first step. The important thing to do is define and complete “bite-sized” programs 
that build on each other, working your way toward the completed project. 

The AstrocrashO f Program 

The AstrocrashOl program creates a graphics window, sets the nebula background, and 
spawns eight asteroids at random locations. The velocity of each asteroid is also randomly 
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calculated, but smaller asteroids have the potential to move faster than larger ones. 
Figure 12.8 shows the program in action. 



Q Figure 12.8 ^ 

A f leLd of moving 
asteroids is the 
foundation of the 
game. 


You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrashOl.py. 

Setting Up the Program 

The program starts like most others: 

# AstrocrashOl 

# Get asteroids moving on the screen 
import random 

from livewires import games 

games.init(screen_width = 640, screen_height = 480, fps = 50) 

I import the random module to generate random x- and y-coordinates for the asteroids. 
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The Asteroid CLass 

The Asteroi d class is used for creating moving asteroids: 

class Asteroid(games.Sprite): 

. An asteroid which floats across the screen. . 

SMALL = 1 
MEDIUM = 2 
LARGE = 3 

images = {SMALL : games.load_itiiage("asteroid_small .bmp"), 
MEDIUM : games. 1 oad_iniage( "asteroid_nied.bmp"), 
LARGE : games.1oad_image("asteroid_big.bmp") ) 


SPEED = 2 

The first thing I do is define class constants for the three different asteroid sizes: SMALL, 
MEDIUM, and LARGE. Then I create a dictionary with the sizes and corresponding asteroid image 
objects. This way, I can use a size constant to look up the corresponding image object. Finally, 
I create a class constant, SPEED, that 111 use as a base to calculate the random speed of each 
asteroid. 

The _init{)_ Method 

Next, 1 taclde the constructor method: 

def_init_(self, x, y, size): 

. Initialize asteroid sprite. """ 

super(Asteroid, self)._init_( 

image = Asteroid.imagesLsize], 

X = X, y = y, 

dx = random.choice([l, -1]) * Asteroid.SPEED * random.randomi)/size, 
dy = random.choice([l, -1]) * Asteroid.SPEED * random.random()/size) 

self.size = size 

The value passed to size represents the size of the asteroid and should be one of the size 
constants: Asteroid.SMALL, Asteroid.MEDIUM, or Asteroi d.LARGE. Based on size, the correct 
image for the new asteroid is retrieved and then passed along to Spri te’s constructor (since 
Spri te is the superclass of Asteroi d). The x and y values passed to Asteroi d for the location of 
the new space rock are also passed on to Spri te’s constructor. 

The Asteroi d constructor generates random values for the new objecfs velocity components 
and passes those off to Spri te’s constructor. The velocity components are random, but smaller 
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asteroids have the potential to move faster than larger ones. Finally, the Asteroi d constructor 
creates and initializes the objecfs si ze attribute. 

The updateO Method 

The update() method keeps an asteroid in play by wrapping it around the screen: 

def update(self): 

. Wrap around screen. . 

if self.top > games.screen.height: 
self.bottom = 0 


if 


self.bottom < 0: 
self.top = games.screen.height 


if self.left > 
self.right 


games.screen.width: 
= 0 


if self.right < 0: 

self.left = games.screen.width 


The main() Function 

Finally, the ma i n () function sets the nebula background and creates eight asteroids at random 
screen locations: 

def main(): 

# establish background 

nebula_image = games.load_image(''nebula.jpg") 
games.screen.background = nebula_image 


# create 8 asteroids 
for i in range(8): 

X = random.randrange(games.screen.width) 
y = random.randrange(games.screen.height) 

size = random.choice([Asteroid.SMALL, Asteroid.MEDIUM, Asteroid.LARGE]) 
new_asteroid = Asteroid(x = x, y = y, size = size) 
games.screen.add(new_asteroid) 


games.screen.mainioop() 
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# kick it off! 
niain() 

RoTATING THE ShIP 

For my next task, I introduce the player’s ship. My modest goal is to allow a user to rotate the 
ship with the arrow keys. I plan to attack the other ship functions later. 

The Astrocrash02 Program 

The Astrocrash02 program extends AstrocrashOl. In the new version, I create a ship at the 
center of the screen that the player can rotate. If the player presses the right arrow key, the 
ship rotates cloclcwise. If the player presses the left arrow key, the ship rotates counterclock- 
wise. Figure 12.9 shows the program in action. 



Q Figure 12.9 ^ 

The pLayer's ship Is 
now part of the 
action. 



You can find the code for the program on the companion wehsite (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrash02.py. 


The Ship CLass 

The main thing I have to do is write a Shi p class for the player’s ship: 
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class Ship(games.Sprite): 

. The player's ship. . 

image = ganies.load_iniage("ship.bnip") 

R0TATI0N_STEP = 3 

def update(self): 

. Rotate based on keys pressed. . 

if ganies.keyboard.is_pressed(ganies.K_LEFT): 

self.angle -= Ship.R0TATI0N_STEP 
i f games. keyboard. i s_pressed(ganies. K_RIGHT): 
self.angle += Ship.ROTATION_STEP 

This class is similar to the Rotate Sprite program from earlier in this chapter, but there are 
some differences. First, i load the image of the ship and assign the resulting image object to 
the class variable image. Second, i use the class constant R0TATI0N_STEP for the number of 
degrees by which the ship rotates. 

Instantiating a Ship Object 

The last thing 1 do in this new version of the game is instantiate a Shi p object and add it to 
the screen. 1 create the new ship in mai n (): 

# create the ship 

the_ship = Ship(image = Ship.image, 

X = games.screen.width/2, 
y = games.screen.height/2) 
games.screen.add(the_ship) 

Moving THE Ship 

in the next version of the program, i get the ship moving. The player can press the up arrow 
key to engage the ship’s engine. This applies thrust to the ship in the direction the ship is 
facing. Since there’s no friction, the ship keeps moving based on ali of the thrust the player 
applies to it. 

The Astrocrash03 Program 

When the player engages the ship’s engine, the AstrocrashOS program changes the velocity 
of the ship based on the ship’s angle (and produces an appropriate sound effect, too). 
Figure 12.10 illustrates the program. 


384 ; 
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Q Figure 12.10 ^ 

The ship can now 
move around the 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrash03.py. 

Importing the math Module 

The first thing I do is import a new module at the top of the program: 
import math, random 

The math module contains a hunch of mathematical functions and constants, but don’t let 
that scare you. 1 use only a few in this program. 

Adding Ship CLass Variable and Constant 

1 create a class constant, VELOCITY_STEP, for altering the ship’s velocity: 

VELOCITY_STEP = .03 

A higher number would make the ship accelerate faster, while a lower number would make 
the ship accelerate more slowly. 

1 also add a new class variable, sound, for the thrusting sound of the ship: 
sound = games.load_sound("thrust.wav'') 
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Modifying Ship's update() Method 

Next, I add code to the end of Shi p’s update( ) method to get the ship moving. I check to see if 
the player is pressing the up arrow key. If so, I play the thrusting sound: 

# apply thrust based on up arrow key 

i f games. key boa rd. i s_pressed(ganies. K_UP): 

Ship.sound.playO 

Now, when the player presses the up arrow key, I need to alter the ship’s velocity components 
(the Shi p ohjecfs dx and dy). So, given the angle of the ship, how can I figure out how much 
to change each velocity component? Well, the answer is trigonometry. Wait, don’t slam this 
hook shut and run as fast as your legs can carry you, screaming incoherently. As promised, I 
use only two mathematical functions in a few lines of code to figure this out. 

To start the process, I get the angle of the ship, converted to radians: 

# change velocity components based on ship's angle 
angle = self.angle * math.pi / 180 # convert to radians 

A radian is just a measure of rotation, like a degree. Python’s math module expects angles in 
radians (while 1 i vewi res works with degrees) so thafs why I need to make the conversion. In 
the calculation, I use the math module constant pi , which represents the numher pi. 

Now that Fve got the ship’s angle in radians, I can figure out how much to change each velocity 
component using the math module’s sin( ) and cos( ) functions, which calculate an angle’s 
sine and cosine. The following lines calculate the ohjecfs new dx and dy values: 

self.dx += Ship.VEL0CITY_STEP * math.sin(angle) 
self.dy += Ship.VELOCITY_STEP * -math.cos(angle) 

Basically, math.sin(angle) represents the percent of the thrust that should be applied to the 
ship’s velocity in the x direction, while the -math.cos(angle) represents the percent of the 
thrust that should be applied to the ship’s velocity in the y direction. 

AU thafs left to do is handle the screen boundaries. I use the same strategy as I did with the 
asteroids: The ship should wrap around the screen. In fact, I copy and paste the code from 
Asteroid’s update( ) method to the end of Ship’s update( ) method: 

# wrap the ship around screen 

if self.top > games.screen.height: 
self.bottom = 0 


if self.bottom < 0: 
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self.top = games.screen.height 

if self.left > games.screen.width: 
self.right = 0 


if self.right < 0: 

self.left = games.screen.width 

Although this works, copying and pasting large portions of code is usually a sign of poor 
design. FU revisit this code later and find a more elegant solution. 



Repeated chunks of code bLoat programs and make them harder to maintain. 
When you see repeated code, it’s often time for a new function or cLass. Think 
about howyou might consolidate the code into one place and call or invoke it 
from the parts of your program where the repeated code currently lives. 


Firing Missiles 

Next, 1 enable the ship to fire missiles. When the player presses the spacebar, a missile fires 
from the ship’s cannon and flies off in the direction the ship is facing. The missile should 
destroy anything it hits—but to keep things simple, 1 save the fun of destruction for another 
version of the program. 

The Astrocrash04 Program 

The Astrocrash04 program allows the player to fire missiles by pressing the spacebar, but 
there’s a problem. If the player holds down the spacebar, a stream of missiles pours out of the 
ship at a rate of about 50 per second. 1 need to limit the missile fire rate, but 1 leave that issue 
for the next version of the game. Figure 12.11 shows off the Astrocrash04 program, warts 
and all. 

You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrash04.py. 
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Modifying Ship's update() Method 

I modify Shi p’s update() method by adding code so that a ship can fire missiles. If the player 
presses the spacebar, a new missile is created: 

# fire missile if spacebar pressed 
if games.keyboard.is_pressed(games.K_SPACE): 

new_missile = Missile(self.x, self.y, self.angle) 
games.screen.add(new_tTtissile) 

Of course, in order to instantiate a new object from Missile(self.x, self.y, self.angle),! 
need to write a little something...like a Missi 1 e class. 

The Missile Class 

I write the Missile class for the missiles that the ship fires. 1 start by creating class variables 
and class constants: 

class Missile(games.Sprite): 

. A missile launched by the player's ship. . 

image = games.load_image("missile.bmp") 
sound = games.load_sound(''missile.wav'') 
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BUFFER = 40 
VEL0CITY_FACT0R = 7 
LIEETIME = 40 

i mage is for the image of a missile—a solid, red circle, sound is for the sound effect of a missile 
launching. BUEFER represents the distance from the ship that a new missile is created (so that 
the missile isn’t created on top of the ship). VEL0CITY_EACT0R affects how fast the missile trav- 
els. Finally, LIFETIME represents how long the missile exists before it disappears (so that a 
missile won’t float around the screen forever). 

The _init_{) Method 

1 start the class constructor with the following lines: 

def_init_(self, ship_x, ship_y, ship_angle): 

. Initialize missile sprite. . 

It may surprise you that the constructor for a missile requires values for the ship’s x- and y- 
coordinates and the ship’s angle, which are accepted into the ship_x, ship_y, and 
shi p_angl e parameters. The method needs these values so that it can determine two things: 
exactly where the missile first appears and its velocity components. Where the missile is 
created depends upon where the ship is located, and how the missile travels depends upon 
the angle of the ship. 

Next, 1 play the missile-firing sound effect: 

Missile.sound.playO 

Then, 1 perform some calculations to figure out the new missile’s starting location: 

# convert to radians 

angle = ship_angle * math.pi / 180 

# calculate missile's starting position 
buffer_x = Missile.BUEEER * math.sin(angle) 
buffer_y = Missi1 e.BUEEER * -math.cos(angle) 

X = ship_x + buffer_x 

y = ship_y + buffer _y 

1 get the angle of the ship, converted to radians. Then, 1 calculate the missile’s starting x- and 
y- coordinates, based on the angle of the ship and the Mi ssi 1 e. BUFEER. The resulting x and y 
values place the missile right in front of the ship’s cannon. 
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Next, I calculate the missile’s velocity components. 1 use the same type of calculations as 1 did 
in the Shi p class: 

# calculate missile's velocity components 

dx = Missile.VELOCITY_FACTOR * math.sin(angle) 
dy = Missile.VELOCITY_FACTOR * -math.cos(angle) 

1 invoke the Spri te constructor for the ohject: 

# create the missile 

super(Missi1 e, self)._init_(image = Missile.image, 

X = X, y = y, 
dx = dx, dy = dy) 

Finally, 1 give the Mi ssi 1 e objecta 1 i feti me attribute so that the objectwon’tbearoundforever. 
self.lifetime = Missile.LIFETIME 

The updateO Method 

Next, 1 write the update() method. Here’s the first part: 

def update(self): 

. Move the missile. . 

# if lifetime is up, destroy the missile 
self.lifetime -= 1 

if self.lifetime == 0: 
self.destroyi) 

This code just counts down the life of the missile. 1 i feti me is decremented. When it reaches 
0, the Missile ohjectdestroys itself. 

In the second part of update(), 1 include the familiar code to wrap the missile around the 
screen: 

# wrap the missile around screen 
if self.top > games.screen.height: 

self.bottom = 0 

if self.bottom < 0: 

self.top = games.screen.height 


if self.left > games.screen.width: 
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self.right = 0 

if self.right < 0: 

self.left = games.screen.width 

I see that the preceding code is now repeated three different times in my program. TU defi- 
nitely be consolidating it later. 

CONTROLLING THE MiSSILE FiRE RaTE 

As you saw in the last program, the ship can fire about 50 missiles per second. Even for a 
player who wants to win, this is a bit much. So in this next version, 1 put a limit on the missile 
fire rate. 

The AstrocrashOS Program 

The AstrocrashOS program limits the missile fire rate by creating a countdown that forces a 
delay between missile firings. Once the countdown ends, the player is able to fire another 
missile. Figure 12.12 illustrates the program. 



Now the ship fires 
missites at a more 
reasonabte rate. 
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You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrashOS.py. 

Adding a Ship Class Constant 

My first step in forcing a delay hetween missile firings is to add a class constant to Shi p: 
MISSILE_DELAY = 25 

MISSI LE_DELAY represents the delay a player must wait hetween missile firings. Fll use it to 
reset a countdown that forces the player to wait. 

Creating Ship's Constructor Method 

Next, 1 create a constructor method for the class: 

def _init_(self, x, y): 

. Initialize ship sprite. . 

super(Ship, self)._init_(image = Ship.image, x = x, y = y) 

self.niissile_wait = 0 

The method accepts values for the x- and y-coordinates of the new ship and passes those off 
to the superclass of Shi p, games. Spri te. The next line gives the new ohject an attribute named 
missi 1 e_wai 1. 1 use missi 1 e_wait to count down the delay until the player can fire the next 
missile. 

Modifying Ship's update() Method 

1 add some code to Shi p’s updatel ) method that decrements anobjecfs mi ssi 1 e_wai t, counting 
it down to 0. 

# if waiting until the ship can fire next, decrease wait 
if self.missile_wait > 0: 

self.missile_wait -= 1 

Then 1 change the missile firing code from the last version of the game to the following lines: 

# fire missile if spacebar pressed and missile wait is over 

if games.keyboard.is_pressed(games.K_SPACE) and self.missile_wait == 0: 
new_missile = Missile(self.x, self.y, self.angle) 
games.screen.add(new_missile) 
self.missi1e_wait = Ship.MISSILE_DELAY 
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Now, when the player presses the spacehar, the countdown must he complete (missi 1 e_wait 
must he 0) before the ship will fire a new missile. Once a missile is fired, 1 reset 
mi ssi 1 e_wai t to MISSI LE_DELAY to hegin the countdown again. 

Handling Collisions 

So far, the player can move the ship around the field of asteroids and even fire missiles, hut 
none of the objects interact. 1 change all of that in this next version of the game. When a 
missile collides with any other object, it destroys that other object and itself. When the ship 
collides with any other object, it destroys the other object and itself. Asteroids will he passive 
in this System, since 1 don’t want overlapping asteroids to destroy each other. 


The Astrocrash06 Program 

The Astrocrash06 program achieves all of the necessary collision detection with the Spri te 
overl appi ng_spri tes property. 1 also have to handle the destruction of asteroids in a special 
way because, when large- and medium-sized asteroids are destroyed, two new hut smaller 
asteroids are created. 



Because the asteroids are initiaLLy generated at random Locations, it's possibLe 
for one to be created on top of the pLayer’s ship, destroying the ship just as the 
program begins. I can Live with this inconvenience for now, but l’LL have to soLve 
this issue in the finaLgame. 


Figure 12.13 shows the program in action. 

You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrash06.py. 
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Modifying Missile's update() Method 

I add the following code to the end ofMissile’s updateO method: 

# check if missile overlaps any other object 
if self.overlapping_sprites: 

for sprite in self.overlapping_sprites: 

sprite.die() 
self.die() 

If a missile overlaps any other objects, the other objects and the missile all have their di e() 
methods called. die( ) is a new method FU be adding to Asteroid, Shi p, and Missi 1 e. 

Adding MissiLe's die() Method 

Missile, like any class in this version of the game, needs a d i e () method. The method is about 
as simple as it gets: 

def die(self): 

. Destroy the missile. . 

self.destroy() 

When a Mi ssi 1 e objecfs di e() method is invoked, the object destroys itself. 
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Modifying Ship's update() Method 

I add the following code to the end of the Shi p’s update( ) method: 

# check if ship overlaps any other object 
if self.overlapping_sprites: 

for sprite in self.overlapping_sprites: 

sprite.dieO 

self.dieO 

If the ship overlaps any other ohjects, the other objects and the ship all have their dieO 
method called. Notice that this exact code also appears in Missi 1 e’s update( ) method. Again, 
when you see duplicate code, you should think about how to consolidate it. In the next version 
of the game, TU get rid of this and other redundant code. 

Adding Ship's die() Method 

This method is the same as Mi ssi 1 e’s di e( ) method: 

def die(self): 

. Destroy ship. . 

self.destroyO 

When a Shi p objecfs di e( ) method is invoked, the object destroys itself. 

Adding an Asteroid CLass Constant 

I add one class constant to Asteroid: 

SPAWN = 2 

SPAWN is the number of new asteroids that an asteroid spawns when it’s destroyed. 

Adding Asteroid's die() Method 

Asteroi d’s die( ) method is more involved than the others: 

def die(self): 

. Destroy asteroid. . 

# if asteroid isn't small, replace with two smaller asteroids 
if self.size != Asteroid.SMALL: 

for i in range(Asteroid.SPAWN): 

new_asteroid = Asteroid(x = self.x, 

y = self.y, 

size = self.size - 1) 
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ganies.screen.add(new_asteroid) 
self.destroy() 

The wrinkle I add is that the Asteroid.SPAWN method has the potential to create new 
Asteroi d objects. The method checks to see if the asteroid being destroyed isn’t small. If it’s 
not, two new asteroids, one size smaller, are created at the current asteroid’s location. 
Whether or not new asteroids are created, the current asteroid destroys itself and the method 
ends. 

Adding Explosions 

In the previous version of the game, the player can destroy asteroids by firing missiles at them, 
but the destruction feels a bit hollow. So next, I add explosions to the game. 

The Astrocrash07 Program 

In the AstrocrashO? program, I write a new class for animated explosions based on 
games .Animati on. I also do some workbehind the scenes, consolidating redundant code. Even 
though the player won’t appreciate these additional changes, they’re important nonetheless. 
Figure 12.14 shows the new program in action. 



Figure 12.14 ) 

ALL of the 
destruction in the 
game is now 
accompanied by 
fiery explosions. 
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You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrash07.py. 

The Wrapper Class 

I start with the behind-the-scenes work. I create a new class, Wrapper, based on gatnes .Spri te. 

The updateQ Method 

Wrapper has an update( ) method that automatically wraps an object around the screen: 

class Wrapper(games.Sprite): 

. A sprite that wraps around the screen. . 

def update(self): 

. Wrap sprite around screen. . 

if self.top > games.screen.height: 
self.bottom = 0 

if self.bottom < 0: 

self.top = games.screen.height 

if self.left > games.screen.width: 
self. ri ght = 0 

if self.right < 0: 

self.left = games.screen.width 

YouVe seen this code several times already. It wraps a sprite around the screen. Now, if I base 
the other classes in the game on Wrapper, its update( ) method can keep instances of those 
other classes on the screen—and the code only has to exist in one place! 

The die() Method 

I finish the class up with a die( ) method that destroys the object: 

def dielself): 

. Destroy self. . 

self.destroyO 

The CoLUder Class 

Next, I take on more redundant code. I notice that both Ship and Missile share the same 
collision handling instructions, so I create a new class, C o 11 i d e r (based on Wrapper), for obj ects 
that wrap around the screen and that can collide with other objects. 
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The updateO Method 

Here’s the update( ) method that handles collisions: 
class Coi 1ider(Wrapper): 

. A Wrapper that can collide with another object. . 

def update(self): 

. Check for overlapping sprites. . 

super(Collider, self).update() 

if self.overlapping_sprites: 

for sprite in self.overlapping_sprites: 

sprite.die() 
self.die() 


The first thing I do in Coi 1 ider’s updateC ) method is invoke its superclass’s update( ) method 
(which is Wrapper’s update( ) method) to keep the ohject on the screen. Then I check for colli¬ 
sions. If the object overlaps any others, 1 call the di e () method for the other objects and then 
the objecfs own die( ) method. 

The die() Method 

Next, 1 have a die( ) method for the class, since all Coi 1 i der objects will do the same thing 
when they die—create an explosion and destroy themselves: 

def die(self): 

. Destroy self and leave explosion behind. . 

new_explosion = Explosion(x = self.x, y = self.y) 

ganies.screen.add(new_explosion) 

self.destroy() 

In this method, 1 create an Expl os i on object. Expl osi on is a new class whose objects are explo¬ 
sion animations. YouTl see the class in its full glory soon. 

Modifying the Asteroid Class 

1 modify Asteroid so that the class is based on Wrapper: 
class Asteroid(Wrapper): 

Asteroid now inherits updateO from Wrapper, so 1 cut Asteroi d’s own update( ) method. The 
redundant code is starting to disappear! 
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The only other thing I do in this class is change the last line of Asteroid’s die( ) method. I 
replace s e 1 f . d i e () with the line 

super(Asteroid, self).die() 

Now, if I ever change Wrapper’s di e( ) method, Asteroi d will automatically reap the benefits. 

Modifying the Ship Class 

I modify Shi p so that the class is based on Coi 1 i der: 
class Ship(Collider): 

In Shi p’s update( ) method, I add the line 
super(Ship, self).update() 

I can now cut several more pieces of redundant code. Since Collider’s updateO method 
handles collisions, I cut the collision detection code from Ship’s updateO method. Since 
Collider’s updateO method invokes Wrapper’s updateO method, I cut the screen wrapping 
code from Ship’s update( ) method, too. I also cut Ship’s die( ) method, as the class inherits 
Collider’sversion. 

Modifying the Missile Class 

In modifying the Missile class, I change its class header so that the class is based on 
Coi 1 ider: 

class Missile(Collider): 

In Missi 1 e’s update( ) method, I add the line 
super(Missile, self).updateO 

Just as with Ship, I can now cut redundant code from Missile. Since Collider’s updateO 
method handles collisions, I cut the collision detection code from Mi ssi 1 e’s update( ) method. 
Since Coi 1 ider’s updateO method invokes Wrapper’s update( ) method, I cut the screen wrap¬ 
ping code from Mi ssi 1 e’s update( ) method, too. I also cut Mi ssi 1 e’s di e( ) method, as the class 
inherits Coi 1 ider’s version. 

To help you understand the changes I describe, feel free to check out the com¬ 
plete code for alL versions of Astrocrash on the book's companion website, 
www.courseptr.com/downLoads. 
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The Explosion Class 

Since I want to create animated explosions, I write an Explosion class based on 
games.Animation. 

class Explosion(games.Animation): 

. Explosion animation. . 

sound = games.load_sound("explosion.wav") 
images = ["explosionl.bmp'', 

"explosion2.bmp'', 

"explosion3.bmp'', 

"explosion4.bmp", 

''explosion5.bmp'', 

''explosion6.bmp'', 

"explosion7.bmp", 

"explosion8.bmp'', 

"explosion9.bmp''] 

I define the class variable, sound, for the sound effect of an explosion. 1 define a class variable, 
i mages, for the list of image file names for the nine frames of the explosion animation. 

Next, 1 write the Expl osi on constructor. 

def _init_(self, x, y): 

super(Explosion, self)._init_(images = Explosion.images, 

X = X, y = y. 

repeat_interval = 4, n_repeats = 1, 
is_collideable = False) 

Explosion.sound.playO 

In the Explosion constructor, 1 accept values into the x and y parameters, which represent 
the screen coordinates for the explosion. When 1 invoke a superclass constructor (the 
games.Animation constructor), 1 pass these values to x and y so that the animation is created 
right where 1 want it. To the superclass constructor, 1 also pass images the list of image file 
names, Expl osi on. images. 1 pass to n_repeats the value 1 so that the animation plays just once. 
1 pass to repeat_i nterval the value 4 so that the speed of the animation looks right. 1 pass 
is_col 1 ideable the value False so that the explosion animation doesn’t count as a collision 
for other sprites that might happen to overlap it. 

Finally, 1 play the explosion sound effect with Expl osi on. sound. pl ay (). 
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Remember, you can pass the games .Animation constructor either a List of fiLe 
names or a List of image objects for the frames of animation. 


AdDING LeVELSj ScOREKEEPINGj and Theme Music 

The game needs just a few more things to feel complete. For my final pass, I add levels— 
meaning that when a player destroys all of the asteroids on the screen, a new, more plentiful 
batch appears. I also add scorekeeping functionality and tense theme music to round out the 
game experience. 

The AstrocrashOS Program 

In addition to levels, scorekeeping, and theme music, 1 add some code that may he less ohvious 
to the player but is stili important to complete the program. Figure 12.15 shows off my final 
version of the game. 



You can find the code for the program on the companion website (www.courseptr.com/ 
downloads) in the Chapter 12 folder; the file name is astrocrashOS.py. 
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Importing the color Module 

The first addition is simple enough. Along with games, I import color from 1 i vewi res: 
from livewires import games, color 

I need the coi or module so that the “Game Over” message can be displayed in a nice, bright 
red color. 

The Game Class 

Toward the end of the program, 1 add the Game class—a new class for an object that represents 
the game itself. Now, creating an object to represent the game may seem like an odd idea at 
first, but it makes sense the more you think about it. The game itself could certainly be an 
object with methods like pl ay () to start the game, advanceC ) to move the game to the next 
level, and end( ) to end the game. 

The design decision to represent the game as an object makes it easy for other objects to send 
the game messages. For example, as the last remaining asteroid in a level is destroyed, the 
asteroid could send the game a message to advance to the next level. Or, just as the ship is 
destroyed, it could send the game a message to end. 

As 1 go through the class, youTl notice that much of the code that was in mai n( ) has been 
incorporated into Game. 

The _init_{) Method 

The first thing 1 do in the Game class is define a constructor: 

class Game(object): 

. The game itself. . 

def _init_(self): 

. Initialize Game object. . 

# set level 
self.level = 0 

# load sound for level advance 

self.sound = games.load_sound("level.wav") 

# create score 

self.score = games.Textlvalue = 0, 

size = 30, 

color = color.white, 
top = 5, 
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right = games.screen.width - 10, 
is_collideable = False) 
games.screen.add(self.score) 

# create player's ship 
self.ship = Ship(ganie = self, 

X = games.screen.width/2, 
y = games.screen.height/2) 
games.screen.add(self.ship) 

1 evel is an attribute for the current game level number. sound is an attribute for the level- 
advance sound effect. score is an attribute for the game score—it’s a Text object that appears 
in the upper-right corner of the screen. The objecfs is_col 1 i deable property is False, which 
means that the score won’t register in any collisions—so the player’s ship won’t “crash into” 
the score and explode! Finally, shi p is an attribute for the player’s ship. 

The pLayO Method 

Next, I define the pl ay ( ) method, which starts up the game. 

def pl ay(sel f): 

. Play the game. . 

# begin theme music 
games.music.loadCtheme.mid") 
games.music.play(-l) 

# load and set background 

nebula_image = games.load_image("nebula.jpg") 
games.screen.background = nebula_image 

# advance to level 1 
self.advance() 

# start play 

games.screen.mainloop() 

The method loads the theme music and plays it so that it will loop forever. It loads the nebula 
image and sets it as the background. Then the method calls the Game objecfs own advance() 
method, which advances the game to the next level. (YouTl see what the advance() method is 
all about next.) Finally, playO invokes games.screen.mainloop( ) to kick off the whole game! 
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The advanceO Method 

The advance() method advances the game to the next level. It increments the level numher, 
creates a new wave of asteroids, displays the level numher briefly on the screen, and plays the 
level-advance sound. 

The first thing I do in the method is simple enough—I increase the level numher: 
def advanceCself): 

. Advance to the next game level. . 

self.level += 1 

The meat of the method is next: creating the new wave of asteroids. Each level starts with the 
numher of asteroids equal to the level numher. So, the first level starts with only one asteroid, 
the second with two, and so on. Now, creating a hunch of asteroids is easy, hut I need to make 
sure that no new asteroid is created right on top of the ship. Otherwise, the ship will explode 
just as the new level begins. 

# amount of space around ship to preserve when creating asteroids 
BUFFER = 150 

# create new asteroids 

for i in rangeiself.level): 

# calculate an x and y at least BUFFER distance from the ship 

# choose minimum distance along x-axis and y-axis 
x_min = random.randrange(BUEFER) 

y_min = BUEFER - x_min 

# choose distance along x-axis and y-axis based on minimum distance 
x_distance = random.randrange(x_min, games.screen.width - x_min) 
y_distance = random.randrange(y_min, games.screen.height - y_min) 

# calculate location based on distance 
X = self.ship.X -i- x_distance 

y = self.ship.y -i- y_distance 

# wrap around screen, if necessary 
x 1 = games.screen.width 

y %= games.screen.height 
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# create the asteroid 
new_asteroid = Asteroid(ganie = self, 

X = X. y = y. 
size = Asteroid.LARGE) 
games.screen.add(new_asteroid) 

BUFFER is a constant for the amount of safe space I want around the ship. 

Next, I start a loop. In each iteration, I create one new asteroid at a safe distance from the 
ship. 

x_fni n is the minimum distance the new asteroid should be from the ship along the x-axis, 
while y_nii n is the minimum distance that the new asteroid should be from the ship along 
the y-axis. I add variation by using the randotn module, but x_nii n and y_mi n will always total 
BUFFER. 

x_di stance is the distance from the ship for the new asteroid along the x-axis. It is a randomly 
selected number that ensures that the new asteroid will be at least x_mi n distance from the 
ship. y_distance is the distance from the ship for the new asteroid along the y-axis. It is a 
randomly selected number that ensures that the new asteroid will be at least y_nn' n distance 
from the ship. 

X is the x-coordinate for the new asteroid. I calculate it by adding the value of the x-coordinate 
of the ship to x_d i s t a n c e . Then I make sure x won’t put the asteroid off the screen by “wrapping 
it around” the screen with the modulus operator, y is the y-coordinate for the new asteroid. 
I calculate it by adding the value of the y-coordinate of the ship to y_di stance. Next, I make 
sure y won’t put the asteroid off the screen by “wrapping it around” the screen with the 
modulus operator. Then, I use x and y to create the brand-new asteroid. 

Notice that there’s a new parameter in the Asteroi d constructor, game. Remember, since each 
asteroid needs to be able to call a method of the Game object, each Asteroid object needs a 
reference to the Game object. So, I pass self to the parameter game, which the Asteroid con¬ 
structor will use as an attribute for the game. 

The last thing I do in advance( ) is display the new level number and play the level-advance 
sound: 

# display level number 

1evel_message = games.Message(value = "Level " + str(self.level), 

size = 40, 

color = coi or.yel 1 ow, 

X = games.screen.width/2. 
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y = games.screen.width/lO, 

1 i feti me = 3 * games.screen.fps, 
is_collideable = False) 
games.screen.addd evel_message) 

# play new level sound (except at first level) 
if self.level > 1: 

self.sound.playO 

The end() Method 

The end( ) method displays the message “Game Over” in the middle of the screen in hig, red 
letters for about five seconds. After that, the game ends and the graphics screen closes. 

def end(self): 

. End the game. . 

# Show 'Game Over' for 5 seconds 
end_message = games.Message(value = "Game Over", 

size = 90, 
color = color.red, 

X = games.screen.width/2, 
y = games.screen.height/2, 
lifetime = 5 * games.screen.fps, 
after_death = games.screen.quit, 
is_col1 ideable = Fal se) 
games.screen.add(end_message) 

Adding an Asteroid Class Variable and Constant 

I make a few changes in the Asteroid class, related to adding levels and keeping score. I add 
a class constant, POINTS: 

POINTS = 30 

The constant will act as a base value for the number of points an asteroid is worth. The actual 
point value will be modified according to the size of the asteroid—smaller asteroids will be 
worth more than larger ones. 

In order to change levels, the program needs to Icnow when all of the asteroids on the current 
level are destroyed. So, I keep track of the total number of asteroids with a new class variable, 
total , which I define toward the beginning of the class: 


total = 0 
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Modifying Asteroid's Constructor Method 

In the constructor, I add a line to increment Asteroi d. total: 

Asteroid.total += 1 

Now, I want any asteroid to be able to send the Game object a message, so I give each Aster¬ 
oi d object a reference to the Game object. I accept the Game object in the Asteroi d constructor 
by creating a new parameter: 

def_init_(self, game, x, y, size): 

The game parameter accepts the Game object, which I then use to create an attribute for the 
new Asteroid object: 

self.game = game 

So, each new Asteroid object has an attribute game that is a reference to the game itself. 
Through game, an Asteroid object can call a method of the Game object, such as advance(). 

Modifying Asteroid's die() Method 

I make a few additions to Asteroi d’s di e( ) method. First, I decrement Asteroi d .total: 
Asteroid.total -= 1 

Next, I increase the score based on Asteroi d. POINTS and the size of the asteroid (smaller aster- 
oids are worth more than larger ones). I also make sure the score is always flush right, so I 
reset the score’s ri ght property to be 10 pixels from the right edge of the screen. 

self.game.score.value -i-= int(Asteroid.POINTS / self.size) 
self.game.score.right = games.screen.width - 10 

When I create each of the two new asteroids, I need to pass a reference to the Game object, 
which I do by modifying the first line of the call to the Asteroid constructor: 

new_asteroid = Asteroidigame = self.game, 

Toward the end of Asteroid’s die( ) method, I test Asteroid.total to see if ali the asteroids 
have been destroyed. If so, the final asteroid invokes the Game objecfs advance ( ) method, which 
advances the game to the next level and creates a new group of asteroids. 

# if all asteroids are gone, advance to next level 
if Asteroid.total == 0: 
self.game.advanceO 
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Adding a Ship CLass Constant 

I make several additions to the Ship class. I create a class constant, VELOCITY_MAX, which I use 
to limit the maximum velocity of the player’s ship; 

VELOCITY_MAX = 3 

Modifying Ship's Constructor Method 

Like an Asteroid object, a Shi p object needs to have access to the Game object so it can invoke 
a Game object method. Just as I did with Asteroi d, I modify the Shi p’s constructor: 

def_init_(self, game, x, y): 

The new parameter, game, accepts the Game object, which I then use to create an attribute for 
the Ship object: 

self.game = game 

So, each Ship object has an attribute game that is a reference to the game itself. Through 
game, a Shi p object can call a method of the Game object, like end(). 

Modifying Ship's update() Method 

In Shi p’s update( ) method, I cap the individual velocity components of a Shi p object, dx and 
dy, using the class constant MAX_VELOCITY: 

# cap velocity in each di rection 

self.dx = min(max(self.dx, -Ship.VELOCITY_MAX), Ship.VELOCITY_MAX) 
self.dy = min(max(self.dy, -Ship.VELOCITY_MAX), Ship.VELOCITY_MAX) 

The code ensures that dx and dy will never be less than - Shi p. VELOCITY_MAX and never greater 
than Shi p. VELOCITY_MAX. I use the min( ) and max() fnnctions to accomplish this. mi n( ) returns 
the minimum of two numbers, while max( ) returns the maximum of two numbers. I cap the 
ship’s speed to avoid several potential problems, including the ship running into its own 
missiles. 

Adding Ship's die() Method 

When the player’s ship is destroyed, the game is over. I add a d i e ( ) method to S h i p that invokes 
the Game objecfs end( ) method to end the game. 

def die(self): 

. Destroy ship and end the game. 

self.game.endO 
super(Ship, self).die() 


II II II 
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The mainO Function 

Now that I have a Game class, the mai n () function becomes quite short. Ali 1 do in this function 
is create a Game object and invoke the objecfs pl ay () method to put the game in action. 

def main(): 

astrocrash = Ganie() 
astrocrash.play() 

# kick it off! 
main() 

SUMMARY 

In this chapter, you extended your knowledge of multimedia programming to include sound, 
music, and animation. You learned how to load, play, and stop both sound and music files, 
and you saw how fo create animations. You also learned a technique for creating large pro- 
grams by writing increasingly more complete, working versions of the final product. You saw 
how to tackle one new objective at a time, building your way to the full program. Finally, you 
saw all of this new information and these new techniques put to use in the creation of a fast- 
paced action game with sound effects, animation, and its own musical score. 


* ' 

Challenges 

1. Improve the Astrocrash game by creating a new kind of deadly 
space debris. Give this new type of debris some quality that 
differentiatos it from the asteroids. For example, maybe the 
debris requires two missile strikes to be destroyed. 

2. Write a version of the Simon Says game where a player has to 
repeatanever-growing, randomsequenceof colorsandsounds 
using the keyboard. 

3. Write your own version of another classic video game such as 
Space Invaders or Pac-Man. 

4. Create your own programming challenge, but, most 
importantly, never stop challenging yourself to learn. 



(^appendix} 


The Companion Website 


T he companion website for this book is available at www.courseptr.com/ 
downloads. From the website, you can download all of the source code, 
supporting files, and Software packages described in this text. 

The Archive Files 

There are two files available for download: 

• py3e_source.zip— contains the source code and supporting files for every 
complete program presented in this book 

• py3e_software—contains files for all of the Software packages described in 
this book, including the lython 3.1.1 Windows installer 

Table A.l describes the contents of py3e_source.zip while Table A.2 details the 
contents of py3e_software.zip. 
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^ Table a. I py3e source.zip Contents ^ 

f - 

-> 

Folder Name 

Description 

chapterO1 

Chapter 1 source code. 

chapter02 

Chapter 2 source code. 

chapter03 

Chapter 3 source code. 

chapter04 

Chapter 4 source code. 

chapterOS 

Chapter 5 source code. 

chapter06 

Chapter 6 source code. 

chapterOZ 

Chapter 7 source code and data files. 

chapter08 

Chapter 8 source code. 

chapter09 

Chapter 9 source code. 

chapter 1 0 

Chapter 1 0 source code and corresponding Windows batch files. 

chapterl 1 

Chapter 1 1 source code, corresponding Windows batch files, and multimedia files. 

chapter 1 2 

Chapter 1 2 source code, corresponding Windows batch files, and multimedia files. 






The pygame Windows instaLLer in the py3e_software.zip file is compatibLe with 
Python 3.1 .x, which means any iteration of Python 3.1 (so Python 3.1.0 through 
Python 3.1.9). 








D 

LIVEWIRES ReFERENCE 


T his appendix includes almost everything you ever wanted to know about 
the modified version of the livewires package but were afraid to ask. I do 
leave out some portions for simplicity—if you want the ultimate “docu- 
mentation,” you can always check out the source code of the livewires modules 
themselves. 

The livewires Package 

The livewires package is a set of modules for writing games with graphics, sound, 
and animation. Table B.l lists two modules. The livewires package requires the 
pygame multimedia package. 
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GAMES Classes 

games contains a group of classes and functions for game programming. Table B.2 describes 
the classes. 



The Screen CLass 

A Screen object represents the graphics screen. The games.init( ) fnnction creates a Screen 
object, screen, that represents the graphics screen. Generally, you should use screen instead 
of instantiating your own object from Screen. Table B.3 describes Screen properties, while 
Table B.4 details Screen methods. 
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^ Table B 

.4 Screen Methods 

f - 

- > 

Method 

Description 

get_width() 

Returns width of screen. 

get_height() 

Returns height of screen. 

get_fps() 

Returns the number of times per second screen is updated. 

get_background() 

Returns the background image of screen. 

set_backgr om(iinew_background) 

Sets the background image of screen to new_bdCkground. 

get_all_objects() 

Returns List of aLl the sprites on the screen. 

get_event_grab() 

Returns the status of the input being grabbed to screen. 

True for input grabbed to screen. Fal S 6 for input not grabbed 
to screen. 

set_event_grab(neii(L5tatos) 

Sets the status of input being grabbed to screen to 
new_StatuS.T rueforinputgrabbedtoscreen. Fal seforinput 
not grabbed to screen. 

adbisprite) 

Adds sprite, a Spn' te object (or an object of a Spri te 
subcLass), to the graphics screen. 

remyeisprite) 

Removes sprf te, a Spri te object (or an object of a Spri te 
subcLass), from the graphics screen. 

clear() 

Removes alL sprites from the graphics screen. 

mainloop() 

Starts the graphics screen’s main loop. 

quit() 

CLoses the graphics window. 




The Sprite Class 

A Spn' te object has an image and can be displayed on a graphics screen. Table B.5 describes 
Spri te properties, while Table B.6 details Spri te methods. 
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^position 

Position of sprite. A two-element tuple that contains the x-coordinate and^ 
the y-coordinate of the object. 

top 

y-coordinate of top sprite edge. 

bottom 

y-coordinate of bottom sprite edge. 

left 

x-coordinate of Left sprite edge. 

right 

x-coordinate of right sprite edge. 

dx 

X velocity. 

dy 

y velocity. 

velocity 

Velocity of sprite. A two-element tuple that contains the x velocity and the 
y velocity of the object. 

overlapping_sprites 

List of other objects that overlap sprite. 

is_collideable 

Whether or not sprite is collideable. True means sprite will register in 
collisions. Fal se means sprite will not show up in collisions. 

interval 

Determines the objecfs ti Ck( ) interval. 




r 

T ABLE 

B.6 

Sprite Methods 


^ Method 




Description 


1 _init_ (image [, angi ei [, 

X] 

[, /] 

Initializes new sprite. image has no default value, so 


1 [, topi L, bottomi [, 

7eft] 

[, 

righti 

one must be passed to it. angi e, X, y, dx, and d/all 


1 [. dx1 [, dyl [, Intervali 



have the default value of 0. top, bottom, left, and 


[, 1s_coll1deable1) 




right have the default value of None. If no value is 
passed to these parameters, the corresponding 
properties are not assigned a value upon 
initialization. interva 1 has a default value of 1. 






iS_COll ideable has a default value of T rue. 


get_image() 




Returns the sprite's image object. 


set_i ma ge ( new_mage) 




Sets the sprite's image object to new_image. 


get_height() 




Returns the height of the sprite's image. 


get_width() 




Returns the width of the sprite's image. 


get_angle() 




Returns the sprite's current angle in degrees. 


set_angle(neiiLang7e) 




Sets the sprite's angle to new_angle. 


get_x() 




Returns sprite’s x-coordinate. 


seLxfneicx; 




Sets sprite's x-coordinate to new_X. 


get_y() 




Returns the objecfs y-coordinate. 


set_y('neiv _y) 




Sets sprite's y-coordinate to new_y. 


get_position() 




Returns the sprite's x- and y-coordinates as a two- 
element tuple. 







J 
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^ set_posit]on{new_posit1on) 

Sets the sprite’s x- and y-coordinates to the two-element 
tu ple new_position. 

get_top() 
set_topinew_top) 
get_bottom() 
set_bottom{ new_bottoin) 

Returns the y-coordinate of the sprite’s top edge. 

Sets the y-coordinate of sprite's top edge to new_top. 

Returns the y-coordinate of the sprite’s bottom edge. 

Sets the y-coordinate of sprite’s bottom edge to 

new_bottoni. 

get_left() 
set_l eft ( new left) 
get_right() 
set_ri ght{new_right) 
get_dx() 
set_dx(neicc/-x) 
get_dy() 
set_dy(neiiLdy) 
get_velocity() 

Returns the x-coordinate of the objecfs Left edge. 

Sets the x-coordinate of sprite's Left edge to new_left. 

Returns the x-coordinate of the object's right edge. 

Sets the x-coordinate of sprite’s right edge to new_r1ght. 
Returns the sprite’s x velocity. 

Sets the sprite’s x velocity to new_dx. 

Returns the sprite’s y velocity. 

Sets the sprite's y velocity to new_dy. 

Returns the sprite's x velocity and the y velocity as a two- 
element tupLe. 

set_vel ocMy {new_velocity) 

Sets the sprite’s x velocity and the y velocity to the two- 
element tupLe new_vel oci ty. 

get_overlapping_sprites() 

Returns a List of alL coLlideable sprites that overlap with the 

overl aps(ot/)er) 

object. 

Returns True if object overlaps with Other and False 
otherwise. Returns Fal se if either object's i S_C0l 1 i deabl 6 
attribute is Fal se. 

get_is_collideable() 

Returns the status of whether or not sprite is coLlideable. 

True means sprite registers in coLlisions. Fal se means sprite 
does not show up in colLisions. 

set_is_col1ideabl e(nehL5tatus) 

Sets the status of whether or not sprite is coLlideable to 
new_StatUS. T rue means sprite registers in coLlisions. Fal se 
means sprite does not show up in coLlisions. 

get_interval () 

set_interval inew_interval) 

update() 

Returns the sprite's ti Ck( ) interval. 

Sets the sprite’s tl Ck( ) interval to new_intervd 7. 

Updates sprite. Does nothing by defauLt. Automatically called 
every mai nl 00p( ) cycle. You might override this method in a 
subcLass of Spri te. 

ti ck( ) 

Executes every interval mainl00p() cycLes. It does nothing 
by defauLt. You might override this method in a subcLass of 

Sprite. 

destroy() 

Removes sprite from the screen. 
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The Text CLass 

Text is a subclass of Spri te. A Text object represents text on the graphics screen. Text of course 
inherits Sprite’s attributes, properties, and methods. Table B.7 describes additional Text 
properties, while Table B.8 details additional Text methods. 



The Text class uses text, size, and color to create an image object that represents the text 
that is displayed. 
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The Message CLass 

Message is a subclass ofText. A Message object represents a message on the graphics screen that 
disappears after a set period of time. A Message object can also specify an event to occur after 
it disappears. 

Message inherits Texfs attributes, properties, and methods. A Message object, however, has a 
new attribute, after_death—code to be executed after the object disappears, such as afunction 
or method name. The default value is None. 

Message defines a new init () method: init ivaTue, size, color [, angle} [, x] [, 

/] [, top] [, bottoml [, 7eft] [, right] [, c/x] [, c/y] [, lifetime] [, is_collideable] 
[, after_death'\). The method initializes a new object. value is the value to be displayed as 
text. size is the size of the text. color is the color of the text. angi e, x, y, dx, and dy all have the 
default value of 0. top, bottom, left, and right have the default value of None. If no value is 
passed to these parameters, the corresponding properties are not assigned a value upon ini- 
tialization. lifetime represents how long the message appears on the screen in mainloopi) 
cycles hefore it destroys itself. If it is given a value of 0, then the object is not set to destroy 
itself. lifetime has a default value of 0. is_collideable has a default value of True. 
after_death has a default value of None. 

The vaLue of the 7 ifetime parameter is simpLy assigned to the Message objecfs 
interva 1 property. A Message object has no 7 i fetime attribute or property. 



The Animation CLass 

The Ani mati on class is a suhclass of Spri te. An Animati on object represents a series of images 
shown in succession. Animation inherits Sprite’s attributes, properties, and methods. Anima¬ 
tion defines additional attributes, described in Tahle B.9. 
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Ani mati on defines a new init 0 method: init (mages [, angi e} [, x] [, /] 

[, top] [, bottoml [, 7eft] [, right] [, c/x] [, dy] [, repeat_intervaU [, n_repeats] 
[, is_collideable~\ ). The method initializes a new object. images can be passed either image 
objects or file names as strings from which to create image objects. angi e, x, y, dx, and dy ali 
have the default value of 0. top, bottom, left, and right have the default value of None. If no 
value is passed to these parameters, the corresponding properties are not assigned a value 
upon initialization. repeat_interval determines the objecfs tickO interval and therefore 
the speed of the animation. The default value is 1. n_repeats has a default value of 0. 
is_col 1 ideablehsLS a default value of True. 

The value of the repeat_interva 1 parameter is simpLy assigned to the Anima - 
tion objecfs interval property. An Animation object has no repeat_interval 
attribute or property. 



The Mouse CLass 

AMouse object provides access to the mouse. The games. i ni t() function creates a Mouse object, 
mouse, for use in reading the mouse position and testing for button presses. Generally, you 
should use mouse instead of instantiating your own object from Mouse. Table B.IO describes 
Mouse properties, while Table B.ll details Mouse methods. 


Table B.IO Mouse Properties 
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set_y(nei((_y) 

get_position() 
set_position(n ew_position) 
set_is_visi b]e{new_visibility) 

i s_presse(i{ button_nuinber) 


Sets the x-coordinate of the mouse pointer to new_y. 
Returns the mouse pointer's x- and y-coordinates as a two- 
eLement tupLe. 

Sets the mouse pointer's x- and y-coordinates to the two- 
eLementtupLe new_position. 

Sets the visibility of the mouse pointer. If new_viSibi 1 71 / is 
True, pointer is visible; if new_visibi 77 ty is Fal se, the 
pointer is not visibLe. 

Tests for a button press. Returns Tfue if mouse button 
button_nuniber is pressed; otherwise, returns Fal se. 


The Keyboard Class 

A Keyboard object provides access to the keyboard. The games. i ni t() function creates a 
Keyboard object, keyboard, for use in testing for keypresses. Generally, you should use 
keyboard instead of instantiatingyour own object from Keyboard. 

The class has a single method, i s_pressed( Trey), which returns T rue if the key being tested for, 
key, is pressed, and False, if not. The games module defines constants that represent keys that 
you can use as an argument for this method. The constants are listed in this appendix, in the 
section “games Constants.” 

The Music Class 

A Mus i c object provides access to the single music channel, allowingyou to load, play, and stop 
a music file. Generally, you should use m u s i c instead of instantiating your own obj ect from Music. 

The music channel accepts many different types of files, including WAV, MP3, OGG, and MIDI. 
Table B.12 lists Musi c’s methods. 


Table B. I 2 Music Methods 


Method 

loadiff/eriame) 

play([7oop]) 


fadeoutCmf/Jfsec) 
stop() 


Descriptiori 

Loads the file fi 7 6773/7/6 into the music channel, repLacingany currentLy loaded 
music file. 

PLays the music Loaded in the music channel Toop number of times in addition 
to its initial pLaying. A vaLue of -1 means Loop forever. The defauLt value of 
loop \s 0. 

Fades out the currentLy playing music in mi 11 isec milLiseconds. 

Stops the music playing on the music channel. 
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GAMES FuNCTIONS 

The games module defines functions for working with images and sound. They are described 
in Table B.13. 


Table B.I3 games Functions 


f 

Function 

ini t([screen_if7c/t/), ] lscreen_height,] 
[fps]) 

A 

Description 

InitiaLizes the graphics screen with width 
screen_width, height screen_heightthat 
updates itself fps times per second. Creates the 
object screen from games. Screen, which 
provides access to the game screen. Creates the 
object mouse from games . Mouse, which provides 
access to the pLayer’s mouse. Creates the object 
keyboard from games. Keyboard, which provides 
access to the pLayer's keyboard. Creates muS i C 
from games . Musi c, which provides access to the 

load_image(f77ename [, transparent]) 

single music channel. 

Returns an image object Loaded from the file 
named in the string f1 1 enaine and sets 
transparency if transparent is True. The defauLt 
valueof transparentisTrue. 

scale_iniage( fmage, x_scale [, y_scale]) 

Returns a new image object scaLed inthexdirection 
by a factor of X_SCa / fiandinthey direction by a 
factor ot y_SCale. If no vaLue is passed to 
y_SCa 1 e, then the image is scaLed by a factor of 
X_SCa 7 e in both directions. The originaL image 

1inage \s unchanged. 

1 oad_sound (ff/eTiame) 

Returns a sound object from a WAV fiLe named in 
the string filename. 




The sound object returned by 1 oad_sound( ) has several methods available to it, which are 
listed in Table B.14. 
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Table B.I4 Sound Object Methods ^ 

f - 

- > 

Method 

Description 

play([7oop]) 

PLays the sound Toop number of times in addition to its initiat pLaying. A vaLue 


of -1 means Loop forever. The defauLt value of 1 OOp is 0. 

1 f adeout (///7 7 7 7Sec) Fadesoutthesoundin/W7 7 7 7SeCmiLLiseconds. 1 

1 stopO 

Stops the sound on atl channeLs. 1 


J 


GAMES CONSTANTS 

The games module defines a list of constants for keyboard keys. The complete list is in 
Table B.15. 
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K_c 

C 

K_KP_PLUS 

Keypad Plus 

K_d 

D 

K_KP_ENTER 

Keypad Enter 

K_e 

E 

K_KP_EQUALS 

Keypad EquaLs 

K_f 

F 

K_UP 

Up Arrow 

K_g 

G 

K_D0WN 

Down Arrow 

K_h 

H 

K_RIGHT 

Right Arrow 

K_i 

1 

K_LEET 

Left Arrow 

K_j 

J 

K_INSERT 

Insert 

K_k 

K 

K_H0ME 

Home 

K_1 

L 

K_END 

End 

K_ni 

M 

K_PAGEUP 

Page Up 

K_n 

N 

K_PAGEDOWN 

Page Down 

K_o 

O 

K_E1 

FI 

K_P 

P 

K_E2 

F2 

K_q 

Q 

K_F3 

F3 

K_r 

R 

K_F4 

F4 

K_s 

S 

K_F5 

F5 

K_t 

T 

K_F6 

F6 

K_u 

U 

K_F7 

F7 

K_v 

V 

K_F8 

F8 

K_w 

w 

K_F9 

F9 

K_x 

X 

K_F10 

FIO 

K_y 

Y 

K_F11 

FI 1 

K_z 

z 

K_F12 

FI2 

K_DELETE 

Delete 

K_NUML0CK 

Num Lock 

K_KP0 

Keypad 0 

K_CAPSLOCK 

Caps Lock 

K_KP1 

Keypad 1 

K_SCR0LL0CK 

ScroLL Lock 

K_KP2 

Keypad 2 

K_RSHIFT 

Right Shift 

K_KP3 

Keypad 3 

K_LSHIFT 

Left Shift 

K_KP4 

Keypad 4 

K_RCTRL 

Right Ctrl 

K_KP5 

Keypad 5 

K_LCTRL 

Left Ctrl 

K_KP6 

Keypad 6 

K_RALT 

Right Alt 

K_KP7 

Keypad 7 

K_LALT 

Left Alt 

K_KP8 

Keypad 8 

K_LSUPER 

Left Windows 

K_KP9 

Keypad 9 

K_RSUPER 

Right Windows 

K_KP_PERIOD 

Keypad Period 

K_HELP 

Help 

K_KP_DIVIDE 

Keypad Divide 

K_PRINT 

Print Screen 

K_KP_MULTIPLY 

Keypad MuLtipLy 

K_BREAK 

Break 

K_KP_MINUS 

Keypad Minus 
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COLOR Module Constants 

The color module provides some constants that you can use anywhere the g a me s module wants 
a color. The constants are as follows: 

• red 

• green 

• bl ue 

• black 

• white 

• dark_red 

• dark_green 

• dark_blue 

• dark_gray 

• gray 

• light_gray 

• yellow 

• brown 

• pink 

• purple 
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Note: Page number followed by a “t” or “f’ 
indicate that the entiy is included in a 
table or figure. 

Special Characters 

- (subtraction operator), 29t 

!= (not-equal-to comparison operator), 56t 

* (number sign symbol), 12-13 
% (modulus operator), 29 

augmented assignment operator, 44t 

* (multiplication operator), 29t 

* (repetition operator), 26-27 

*= augmented assignment operator, 44t 
/ (forward slash), 211 
II (integer division operator), 29t 
/ (true division operator), 29t 
/= augmented assignment operator, 44t 
\ (backslashes), 22-23, 24t, 26 
\“ (double quote escape character), 23, 24t 
\ (line continuation character), 26 
\’ (single quote escape character), 23, 24t 
_ (underscore characters), 234 
+ (addition operator), 29t 
+ (concatenation operator), 26, 41,115 
+= augmented assignment operator, 44t 
< (less-than comparison operator), 56t 
<= (less-than-or-equal-to comparison operator), 
56t 

— augmented assignment operator, 44t 
== (equal-to comparison operator), 55, 56t 
> (greater-than comparison operator), 56t 
>= (greater-than-or-equal-to comparison 

operator), 56t 


A 

\a (system hell character), 23, 24t 
“ab” binary file access mode, 201t 
“ab+” binary file access mode, 201t 
abstraction, 162,165 
add() method 

Pla 5 dng Cards program, 254 
sprites, 333 

addition operator (+), 29t 

_additional_cards() method, 279-281 

add(sprite) screen method, 326t, 413t 
advance() method, 403-405 
after_death message attribute, 340t 
algori thms 

applying stepwise refinement to, 81 
creating with pseudocode, 80-81 
defined, 80 
Alien Blaster program 
OverView, 249 
receiving messages, 251 
sending messages, 251 
all objects screen property, 326t 
American Standard Code for Information 
Interchange (ASCII) Art, 21 
and logical operator, 78-79 
angle property, 334t, 368, 413t 
animation 

creating Animation object, 371-372 
creating list of image files, 370-371 
examining images, 369-370 
OverView, 368-369 

Animation class, 370-372, 412t, 417-418 
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append() list method, 130,132t 
applicatiori class, defining, 297 
application object, creating, 298 
archive files, 409-410 
arguments, exception, 209 
arrays, 112 

ASCII (American Standard Code for 
Information Interchange) Art, 21 
ask_number() function, 177t, 179, 270 
ask_^es_no() function, 165-166,177t, 179,269 
assignment statements, defined, 31 
Asteroid class 

_init_() method, 380-381 

constructor method, 406 
die() method, 394-395, 406 
modifying, 397-398 
OverView, 394 
update() method, 381 
variable and constant, 405 
Asteroid.SPAWN method, 395 
Astrocrash game 
asteroids 

Asteroid class, 380-381 
main() function, 381-382 
OverView, 378-379 
setting up program, 379 
collisions 

Asteroid class, 394-395 
Missile class, 393 
OverView, 392-393 
Ship class, 394 
explosions 

Asteroid class, 397-398 
Collider class, 396-397 
Explosion class, 399-400 
Missile class, 398 
OverView, 395-396 
Ship class, 398 
Wrapper class, 396 


firing missiles 

controlling fire rate, 390-392 
Missile class, 387-390 
OverView, 386-387 
Ship class, 387 
levels, 401-408 
moving ship 

importing math module, 384 
OverView, 383-384 
Ship class, 384-386 
OverView, 361-362 
planning 
assets, 378 
features, 377-378 
rotating ship 

instantiating Ship object, 383 
OverView, 382 
Ship class, 382-383 
scorekeeping, 401-408 
theme music, 401-408 
AstrocrashOl program 
Asteroid class 

_init_() method, 380-381 

update() method, 381 
main() function, 381-382 
OverView, 378-379 
setting up, 379 
Astrocrash02 program 

instantiating Ship object, 383 
OverView, 382 
Ship class, 382-383 
Astrocrash03 program 

importing math module, 384 
OverView, 383-384 
Ship class 

update() method, 385-386 
variable and constant, 384 
Astrocrash04 program 
Missile class 
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_init_() method, 388-389 

OverView, 387-388 
update() method, 389-390 
OverView, 386-387 
Ship class, 387 
AstrocrashOS program 
constructor method, 391 
firing missiles, 390-391 
Ship class, 391-392 
Astrocrash06 program 
Asteroid class 

die() method, 394-395 
OverView, 394 
Missile class 

die() method, 393 
update() method, 393 
OverView, 392-393 
Ship class 

die() method, 394 
update() method, 394 
Astrocrash07 program 
Asteroid class, 397-398 
Collider class 

die() method, 397 
OverView, 396 
update() method, 397 
Explosion class, 399-400 
Missile class, 398 
OverView, 395-396 
Ship class, 398 
Wrapper class 

die() method, 396 
update() method, 396 
Astrocrash08 program 
Asteroid class 

constructor method, 406 
die() method, 406 
variable and constant, 405 
Game class 


_init_() method, 401-402 

advance() method, 403-405 
end() method, 405 
play() method, 402 
importing color module, 401 
main() function, 408 
OverView, 400 
Ship class 

adding constant, 407 
constructor method, 407 
die() method, 407 
update() method, 407 
Attribute Critter program 

accessing attributes, 227-228 
initializing attributes, 226-227 
OverView, 225-226 
printing objects, 228 
attributes 

accessing, 227-228 
controlling access to 

accessing properties, 240-241 
creating properties, 238-240 
OverView, 238 
initializing, 226-227 
OOP, 219 

OverView, 225-226 
printing, 228 
audio 
music 

loading, 375-376 
looping, 376 
playing, 376 
stopping, 376 
theme, 401-408 
OverView, 372 
sounds 

loading, 373 
looping, 374-375 
playing, 373-374 
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stopping, 375 
System bell, 23-24 

augmented assignment operators, 44 

B 

Background Image program 
loading images, 328 
OverView, 327 
setting background, 328 
background images 
loading, 328 
OverView, 326-327 
setting, 328 

background property, 326t, 412t 
backslashes (\), 22-23, 24t, 26 
Base class 

creating, 257-258, 263 
inheriting from, 258—259 
involdng methods, 264-265 
overriding methods, 264 
batch files, 289-290 
Big Score program 

importing color module, 336 
OverView, 335-336 
Text object 

adding to screen, 337 
creating, 336-337 
binary file access modes, 201t 
binding events, 288 
Birthday Wishes program 
OverView, 167-168 

using default parameter values, 169-171 
using positional parameters 
and keyword arguments, 169 
and positional arguments, 168-169 
“bite-sized” programs, 378 
BJ_Card class, 274t, 275-276 
BJ_Dealer class, 274t, 279 
BJ_Deck class, 274t, 276 
BJ_Game class 


_additional_cards() method, 280-281 

_init_() method, 280 

OverView, 274t, 279 
play() method, 281-282 
still_playing property, 280 
BJ_Hand class, 274t, 276-278 
BJ_Hand is_busted() method, 278 
BJ_Player class, 274t, 278-279 
Blackjack game 

BJ_Card class, 275-276 
BJ_Dealer class, 279 
BJ_Deck class, 276 
BJ_Game class 

_additional_cards() method, 280-281 

_init_() method, 280 

OverView, 279 
play() method, 281-282 
still_playing property, 280 
BJ_Hand class, 276-278 
BJ_Player class, 278-279 
cards module, 271-273, 275 
designing classes, 273-274 
games module, 275 
main() function, 282-283 
writing pseudocode for game loop, 274-275 
blank lines, 13 
blocks 

creating initial, 82 
defined, 56 
loop bodies, 65-66, 72 
using indentation to create, 57 
bookends, 23 
Boole, George, 308 
Boolean variables, 308 
BooleanVar object, 310 
bottom property, 334t, 414t 
Bouncing Pizza program 

deriving new class from sprite, 344 
overriding update() method, 344-345 
OverView, 343 
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setting up, 343-344 
wrapping up, 345 
branching, defined, 53 
break statement 

using to exit loops, 73 
when to use, 73-74 
bugs, 9 

bust() method, 279 
busting, 248 
Button element, 288t 
buttons 

creating, 295-296 

entering root window event loop, 296 
OverView, 294 

c 

C language, 3-4 
“c” shelf access mode, 204 
C# language, 3-4 
C++ language, 3-4 
called variable, 46 
calling, defined, 8 
capitalize() method, 38t 
Card class 

combining using Hand object, 255-256 
creating, 252-253 
using, 254 
cards module 
importing, 275 
OverView, 271-273 
case sensitivity, 8 
change_global() function, 175 
characters 

reading from files, 194 
reading from lines, 195 
Check button element, 288t 
check buttons 

allowing widget master to be only 
reference, 307-308 
creating, 308-309 


getting status of, 310 
OverView, 306-307 
check_catch() method, 354-355 
check_drop() method, 358-359 
Chef class 

_init_() method, 357 

check_drop() method, 358-359 
OverView, 356-357 
update() method, 357-358 
class attributes 
accessing, 231 
assigning new value to, 231 
creating, 230 
OverView, 228-230 
classes 

creating GUls using 

creating Application object, 298 
defining Application class, 297 
defining constructor method, 297 
defining method to create widgets, 
297-298 

importing tkinter module, 297 
OverView, 296 
defining, 220-221 
designing, 273-274 
imported, 270 
inheritance 

creating through, 256 
extending through, 256-262 
OOP, 219 

Classy Critter program 
class attributes 
accessing, 231 
creating, 230 
OverView, 229-230 
static methods 

creating, 231-232 
invoking, 232 

clear() screen method, 254, 326t, 413t 
Click Counter program 
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event handlers 
binding, 300 
creating, 300 
OverView, 299 
setting up, 299 
wrapping up, 300-301 
Client of function, 232 
Clippy the Office Assistant sprite, 330 
close() function, 193,199t 
closing files, 193 
code, defined, 9 
Collider class 

die() method, 397 
OverView, 396 
update() method, 397 
collisions 

Astrocrash game, 392-395 
detecting, 350-351 
handling, 351 
OverView, 349-350 
color module 
constants, 423 
importing, 336, 339, 401 
livewires package, 41 It 
OverView, 411 
color property, 337t, 416t 
column parameter, 303 
columnspan parameter, 303 
command option, 300 
comments, 12-13 
community, 4 

companion wehsite, 5, 409-410 
comparison operators, 55-56 
compound conditions 

and logical operator, 78-79 
not logical operator, 77-78 
or logical operator, 79 
OverView, 74-77 

computer_move() function, 177t, 183-185 


concatenating 
defined, 25 
lists, 126 
strings, 25-26 
tuples, 115-116 

concatenation operator (+), 26, 41,115 
conditions 
creating, 55 
defined, 55 

that can become false, 69 
treating tuples as, 110 
treating values as 

interpreting any value as true or false, 
71-72 

OverView, 69-71 
configure() method, 295 
congrat_winner() function, 177t, 186 
console window, 2 
constants 

color module, 423 
creating, 149-152 
defined, 102 
games module, 421-422 
Constructor Critter program 
creating constructors, 224 
creating multiple objects, 224 
OverView, 222-223 
constructor method 

accessing class attributes, 231 
Application class, 297, 315 
Asteroid class, 406 
Critter class, 242 
Message class, 339 
Ship class, 391, 407 
constructors 
creating, 224 
creating multiple, 224 
OverView, 222-223 
continue statement 
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using to jump back to the top of loops, 73 
when to use, 73-74 
cos() function, 385 
count() list method, 132t 
Counter program 

counting with for loops 
baclewards, 93 
by fives, 93 
forwards, 92 
OverView, 90-92 
counter variables, 92 
Craps Roller program 

importing random module, 51-52 
OverView, 50-51 
randint() function, 52 
randrange() function, 52-53 
create_widgets() method, 297-298, 302, 315- 
317 

Critter Caretaker program 

creating menu system, 244-245 
Critter class 

_pass_time() method, 242 

constructor method, 242 
creating, 244 
eat() method, 243 
mood property, 242-243 
play() method, 244 
talk() method, 243 
OverView, 217-219, 241 
starting, 245 
Critter class 

_pass_time() method, 242 

constructor method, 242 
creating, 244 
eat() method, 243 
mood property, 242-243 
play() method, 244 
talk() method, 243 
cross-platform text files, 190 
cr 5 ^tography, 54 


D 

database management system (DBMS), 77 

deal() method, 261 

decimal module, 30 

Deck class, 256 

decorators, 232 

Deep Blue computer, 183 

default parameter values, 167,169-171 

dei keyword, 127-128 

delete() method, 305 

deleting 

key-value pairs, 146-147 
list elements, 127-128 
list slices, 128 
derived classes 
defined, 258 
extending, 259-260 
using, 260-262, 265-266 
destroy() method, 334t, 356, 415t 
development environment, 7. See also IDLE 
dictionaries 

creating, 141-142 
dictionaiy requirements, 147-148 
getting, 145 
key-value pairs 
adding, 145-146 
deleting, 146-147 
replacing, 146 
OverView, 118,140-141 
retrieving values 

testing for key with in operator hefore, 
143 

using get() method, 143-144 
using key, 142-143 
die() method 

Asteroid class, 394-395, 406 
Collider class, 397 
Missile class, 393 
Ship class, 394, 407 
Wrapper class, 396 
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display() function, 163-164 
display_board() function, 177t, 180 
display_instruct() function, 177t, 178-179 
displaying sprites, 329-334 
division, 29 
division operators, 29t 
docstring (documentation string), defined, 
161 

documenting functions, 161 
dot notation, 52, 270 

double quote escape character (\”), 23, 24t 
Drama check button, 309 
dump pickle function, 203t 
dx property, 334t, 414t 
dy property, 334t, 414t 

E 

eat() method, 243 
elements 

creating tuples with, 111 
list 

assigning new by index, 126-127 
deleting, 127-128 
nested, 135 
string, 111-112 
tuple, 111-112 
elif clause, 59-63 
else clause, 57-59, 62, 210 
encapsulation 

abstraction versus, 165 
object, 232-233 
end() method, 405 
end parameter, 20 
end points, 106-108 
end_game() method, 356 
Entry widget, 303-304 
equal-to comparison operator (==), 55, 56t 
escape sequences 

inserting newline character, 23 


inserting quotes, 23 
moving forward one tab stop, 

21-22 

OverView, 21 

printing backslash, 22-23 
sounding system bell, 23-24 
event handlers 
binding, 300 
creating, 300 
defined, 288 
OverView, 298-299 
eventloop 
defined, 288 

entering root window, 292, 294, 296 
event_grab property, 326t, 412t 
event-driven programming, 288-289. See also 
graphical user interfaces (GUls) 
except clause, 207, 209 
exception handling 

adding else clause, 210 
getting argument, 209 
handling multiple t 5 q>es of, 208-209 
OverView, 205-206 
specifying type of, 207-208 
using try statement with except 
clause, 206 

Exclusive NetWork program 
and logical operator, 78-79 
not logical operator, 77-78 
or logical operator, 79 
OverView, 74-77 
Explosion class, 399-400 
Explosion program 

creating Animation object, 371-372 
creating list of image files, 370-371 
explosion images, 369-370 
OverView, 368-369 
setting up, 370 
expressions, defined, 29 
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F 

fadeout() method, 419t, 421t 
False value, 68-72 
Fancy Credits program 

inserting newline character, 23 
inserting quotes, 23 
moving forward one tab stop, 21-22 
OverView, 21 

printing backslash, 22-23 
sounding system bell, 23-24 
files 

reading from 

looping through files, 196-197 
opening and closing files, 193 
OverView, 190-192 
reading all lines into lists, 196 
reading characters, 194-195 
storing complex data in 
OverView, 200 
pickling data, 200-202 
shelves, 203-205 
unpickling data, 202-203 
writing 

list of strings to files, 198-199 
OverView, 197 
strings to files, 197-198 
Finicky Counter program 
break statement, 73-74 
continue statement, 73-74 
OverView, 72-73 
fiip_first_card() method, 279 
fioat() function, 43t 
fioating-point numbers (fioats), 29 
for loops 

counting with 
baclcwards, 93 
by fives, 93 
forwards, 92 
OverView, 90-92 


creating, 90 

looping through files, 196 
in other languages, 90 
OverView, 88-90 
forward slash (/), 211 
fps (frames per second), 325 
fps screen property, 326t, 412t 
Frame element, 288t 
frames 

animation and, 369 
creating, 293 

frames per second (fps), 325 
from statement, 324 
function definitions, defined, 161 
functions 

abstraction, 162 

calling programmer-created, 161 

creating list of, 177 

defined, 8 

defining, 161 

documenting, 161 

games module, 420-421 

global variables 

changing from inside, 175 
reading from inside, 174 
shadowing from inside, 174 
imported, 270 
OverView, 159-160 

receiving and returning values in same, 
165-166 

G 

Game class 

_init_() method, 401-402 

advance() method, 403-405 
end() method, 405 
play() method, 402 
Game Over program 
blank lines, 13 
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comments, 12-13 
OverView, 1-2 
printing string, 13-14 
using Interactive mode 
error generation, 9 
print() function, 8 
syntax highlighting, 9 
terminology, 8-9 
writing program, 7-8 
using script mode 

running program, 11-12 
saving program, 11-12 
writing program, 10 
waiting for user, 14 
Game Over 2.0 program 
OverView, 16-18 
printing multiple values, 19 
specilying final string to print, 19-20 
triple-quoted strings, 20-21 
using quotes inside strings, 18-19 
games init() function, 325 
games init() method, 353 
games load_image() function, 328 
games module 

Animation class, 417-418 
constants, 421-422 
functions, 420-421 
importing, 275, 324-325 
Keyboard class, 419 
livewires package, 41 It 
Message class, 417 
Mouse class, 418-419 
Music class, 419 
OverView, 411-412 
Screen class, 412-413 
Sprite class, 413-415 
Text class, 416 
Geek Translator program 
dictionaries 


creating, 141-142 
getting, 145 
OverView, 140-141 
requirements, 147-148 
key-value pairs 

adding, 145-146 
deleting, 146-147 
replacing, 146 
retrieving dictionaiy values 

testing for key with in operator before, 
143 

using get() method, 143-144 
using key, 142-143 
setting up, 144 
wrapping up, 147 
geometry() method, 292 
get() method, 143-144 
get() method, 148t, 304-305 
get_all_objects() screen method, 413t 
get_angle() method, 414t 
get_hackground() screen method, 413t 
get_hottom() method, 415t 
get_color() method, 416t 
get_dx() method, 415t 
get_dy() method, 415t 
get_event_grab() screen method, 413t 
get_fps() screen method, 413t 
get_height() method, 413t-414t 
get_image() method, 414t 
get_interval() method, 415t 
get_is_collideable() method, 415t 
get_left() method, 415t 
get_overlapping_sprites() method, 415t 
get_position() method, 414t, 419t 
get_right() method, 415t 
get_size() method, 416t 
get_top() method, 415t 
get_value() method, 416t 
get_velocity() method, 415t 
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get_width() method, 413t-414t 
get_x() method, 414t, 418t 
get_y() method, 414t, 418t 
give() method, 254 
give_me_five() fimction, 164-165 
global constants, 175 
Global Reach program 

changing global variables from inside 
function, 175 
OverView, 172-173 
reading global variables from inside 
function, 174 

shadowing global variables from inside 
function, 174 

when to use global variables and constants, 
175 

global scope, 172 
global variables 

changing from inside function, 175 

defined, 172 

OverView, 172-173 

reading from inside function, 174 

scopes, 171-172 

shadowing from inside function, 174 
when to use, 175 
Granted or Denied program 
else clause, 59 
OverView, 57-59 

graphical user interfaces (GUls), 285-319 
buttons 

creating, 295-296 

entering root window event loop, 296 
OverView, 294 
check buttons 

allowing widget master to be only 
reference, 307-308 
creating, 308-309 
getting status of, 310 
OverView, 306-307 


creating using classes 

creating Application object, 298 
defining Application class, 297 
defining constructor method, 297 
defining method to create widgets, 
297-298 

importing tkinter module, 297 
OverView, 296 
event handlers 
binding, 300 
creating, 300 
OverView, 298-299 
event-driven programming, 288-289 
Grid layout manager 

creating Entry widget, 303-304 
creating Text widget, 304 
OverView, 301-302 
placing widgets with, 302-303 
text-based widgets, 304-306 
labeis 

creating, 293-294 

creating frames, 293 

entering root window event loop, 294 

OverView, 292 

setting up program, 292-293 
Mad Lib program 

constructor method, 315 
create_widgets() method, 315-317 
importing tkinter module, 314 
mainloop() method, 318-319 
OverView, 285-286 
tell_stoiy() method, 317-318 
OverView, 287-288 
radio buttons 

creating, 312-313 

getting value from group of, 313-314 
OverView, 311 
root window 
creating, 291 
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entering event loop, 292 
importing tldnter module, 291 
modifying, 291-292 
OverView, 289-290 
graphics 

background images 
loading, 328 
OverView, 326-327 
setting, 328 
collisions 

detecting, 350-351 
handling, 351 
OverView, 349-350 

graphics coordinate system, 328-329 
graphics window 

importing games module, 324-325 
initializing graphics screen, 325 
OverView, 323-324 
starting main loop, 326 
messages 

importing color module, 339 
Message object, 339-340 
OverView, 337-339 
using screen width and height, 340 
mouse input 

grabbing input to graphics window, 348 
OverView, 345-346 
reading x- and y-coordinates, 347 
setting pointer visibility, 347-348 
Pizza Panic game 

Chef class, 356-359 
main() function, 359 
OverView, 321-322 
Pan class, 353-355 
Pizza class, 355-356 
setting up, 352-353 
pygame and livewires packages, 323 
screen houndaries 

deriving classes from sprites, 344 


overriding update() method, 344-345 
OverView, 342-343 
sprites 

adding to screen, 333-334 
creating, 333 

loading images for, 331-333 
moving, 340-342 
OverView, 329-331 
text 

importing color module, 336 
OverView, 335-336 
Text object, 336-337 
graphics coordinate system, 328-329 
graphics window 

grabbing input to, 348 
importing games module, 324-325 
initializing graphics screen, 325 
OverView, 323-324 
starting main loop, 326 
greater-than comparison operator (>), 56t 
greater-than-or-equal-to comparison operator 
(>=), 56t 

Greeter program 

creating variahles, 31 
naming variables, 32 
OverView, 30-31 
using variables, 31 
grid() method, 293, 302 
Grid layout manager 

creating Entiy widget, 303-304 
creating Text widget, 304 
grid() method, 293 
OverView, 301-302 
placing widget with, 302-303 
text-based widgets, 304-306 
Guess My Number game 
congratulating player, 84 
creating guessing loop, 83 
creating initial comment block, 82 
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explaining game, 83 
importing random module, 83 
OverView, 50 

planning program, 81-82 
setting initial values, 83 
waiting for player to quit, 84 
guessing loop, creating, 83 
GUIs. See graphical user interfaces (GUIs) 


Hand class 

combining Card objects using, 255-256 
creating, 253-254 
Handle It program 

adding else clause, 210 
getting exception argument, 209 
handling multiple exception types, 
208-209 

OverView, 205-206 
specifying exception type, 207-208 
using try statement with except clause, 206 
handle_caught() method, 356 
handle_collide() method, 351 
Hangman game 

checking guess, 153-154 
creating constants, 149-152 
creating main loop, 152-153 
ending, 154 
getting guess, 153 
initializing variables, 152 
OverView, 121-123 
setting up, 148-149 
height property, 326t, 412t-413t 
Helio World program, 2 
Hero’s Inventory program 
OverView, 109-110 
tuples 

creating empty, 110 
creating with elements, 111 


looping through elements of, 111-112 
printing, 111 
treating as condition, 110 
Hero’s Inventory 2.0 program 
len() function, 113-114 
in operator, 114 
setting up, 113 
tuples 

concatenating, 115-116 
immutability of, 115 
indexing, 114 
OverView, 112-113 
slicing, 114-115 
Hero’s Inventory 3.0 program 
list elements 

assigning new by index, 126-127 
deleting, 127-128 
list slices 

assigning new, 127 
deleting, 128 
lists 

concatenating, 126 
creating, 124-125 
indexing, 125 
mutability of, 126 
slicing, 125-126 
using in operator with, 125 
using len() function with, 125 
OverView, 123-124 
High Scores program 

dealing with invalid choices, 132 
displaying menu, 129-130 
exiting, 130 
OverView, 128-129 
scores 

adding, 130 
displaying, 130 
removing, 131 
sorting, 131-132 
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setting up, 129 
waiting for user, 132 
High Scores 2.0 program 

accessing nested elements, 135 
creating nested sequences, 134-135 
dealing with invalid choices, 137 
OverView, 133-134 
scores, 137 
setting up, 136-137 
unpacking nested sequences, 136 
waiting for user, 138 
high-level languages, 3 
human_move() function, 177t, 182-183 


IDLE 

interactive mode 

error generation, 9 
print() function, 8 
syntax highlighting, 9 
terminology, 8-9 
writing programs, 7-8 
script mode 

running programs, 11-12 
saving programs, 11-12 
writing programs, 10 
if statement 
building, 57 

comparison operators, 55-56 
creating conditions, 55 
OverView, 53-55 

using indentation to create blocks, 56-57 
image property, 334t, 413t 
images attribute, 417t 
immutability 
defined, 100 
string, 100-101 
tuple, 115 

import statement, 270 


importing 

cards module, 275 
color module, 336, 339, 401 
games module, 275, 324-325 
math module, 384 
modules, 269-270 
tldnter module, 291, 297, 314 
“impossible” slices, 107 
in operator 
OverView, 95 

testing for keys with, 143 
using with lists, 125 
using with tuples, 114 
indentation, using to create blocks, 56-57 
index() list method, 132t 
IndexError exception type, 207t 
indexing 
defined, 96 
lists, 125 
strings 

negative position numbers, 98-99 
OverView, 95-97 

positive position numbers, 97-98 
random module, 99 
tuples, 114 
infinite loops 

creating conditions that can become false, 
69 

creating intentional 

break statement, 73-74 
continue statement, 73-74 
OverView, 72-73 
OverView, 66-68 
tracing program, 68 
inheritance 

altering behavior of inherited methods 
creating Base class, 263 
invoking Base class methods, 264-265 
overriding Base class methods, 264 
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OverView, 262-263 
using derived classes, 265-266 
creating classes, 256 
extending classes through, 256-262 
init() function, 420t 

_init_() method 

Asteroid class, 380-381 
BJ_Game class, 280 
Chef class, 357 
Game class, 401-402 
Missile class, 388-389 
Pan class, 353-354 
Pizza class, 355 
sprites, 414t 
text, 416t 

initialization method. See constructor method 
input() function 

Guess My Number game, 83 
GUI programs, 288 
Personal Greeter program, 34-35 
Trust Fund Buddy program, 40-41, 43 
Useless Trivia program, 45 
insert() method, 132t, 305-306 
installing Python on Windows, 5-6 
instance method, 221 
instances, OOP, 219 
instantiating objects, 219, 222, 383 
instructions() function, 161-162 
Instructions program 
abstraction, 162 

calling programmer-created functions, 161 
defining functions, 161 
documenting functions, 161 
OverView, 159-160 
int() function 

Guess My Number game, 83 
Trust Fund Buddy program, 43 
integer division, 29 
integer division operator (//), 29t 


integers 

converting strings to, 42-43 
defined, 28-29 
interactive mode, IDLE 
error generation, 9 
print() function, 8 
saving and running programs, 11-12 
syntax highlighting, 9 
terminology, 8-9 
writing programs, 7-8 
interval property, 414t 
invalid choices, dealing with, 132,137 
lOError exception type, 207t 
is_collideable property, 334t, 414t 
is_hitting() method, 279 
is_pressed() method, 364-365, 419t 
is_visible property, 348t, 418t 
items() dictionaiy method, 148t 
iterating, defined, 90 

J 

Java, 3-4 

K 

keyboard,reading 
OverView, 363 
setting up program, 364 
testing for keystrokes, 364-365 
wrapping up program, 365 
Keyboard class, 412t, 419 
keyboard constants, 365 
keyboard object, 325t 
KeyError exception type, 207t 
keys 

OverView, 140-141 
testing for with in operator, 143 
using for retrieving dictionary values, 
142-143 

keys() dictionary method, 148t 
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keystrokes, testing for, 364-365 
key-value pairs 
adding, 145-146 
deleting, 146-147 
replacing, 146 
keyword arguments, 169 


Label element, 288t 
Label widget, 292 
Labeler program 
creating frame, 293 
creating label, 293-294 
entering root window event loop, 294 
OverView, 292 
setting up, 292-293 
labeis 

creating, 293-294 

creating frames, 293 

entering root window event loop, 294 

OverView, 292 

layout manager. See Grid layout manager 
Lazy Buttons program 

creating buttons, 295-296 
entering root window event loop, 296 
OverView, 294 
setting up, 294-295 
Lazy Buttons 2 program 

creating Application object, 298 
defining Application class, 297 
defining constructor method, 297 
defining method to create widgets, 297-298 
importing tldnter module, 297 
OverView, 296 
left property, 334t, 414t 
legal_moves() function, 177t, 180-181 
len() function 
OverView, 95 
using with lists, 125 


using with tuples, 113-114 
less-than comparison operator (<), 56t 
less-than-or-equal-to comparison operator (<=), 
56t 

lifetime message attribute, 340t 
line continuation character (\), 26 
lines 

blank, 13 

reading all into lists, 196 
reading characters from, 195 
list methods 

dealing with invalid choice, 132 
displaying menu, 129-130 
exiting program, 130 
OverView, 128-129 
scores 

adding, 130 
displaying, 130 
removing, 131 
sorting, 131-132 
waiting for user, 132 
lists 

concatenating, 126 
creating, 124-125 
defined, 92 
elements 

assigning new by index, 126-127 
deleting, 127-128 
offunctions, 177 
of image files, 370-371 
indexing, 125 
mutability of, 126 
OverView, 118,123-124 
reading all lines into, 196 
slices 

assigning new, 127 
deleting, 128 
slicing, 125-126 
using in operator with, 125 
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using len() function with, 125 
when to use tuples instead of, 133 
writing to files, 198-199 
livewires package 
color module 
constants, 423 
OverView, 411 
games module 

Animation class, 417-418 
constants, 421-422 
functions, 420-421 
Keyboard class, 419 
Message class, 417 
Mouse class, 418-419 
Music class, 419 
OverView, 411-412 
Screen class, 412-413 
Sprite class, 413-415 
Text class, 416 
OverView, 323, 411 
load() method, 419t 
load pickle function, 203t 
load_image() function, 328 
load_sound() function, 420t 
local variables, defined, 172 
logical errors, tracldng down, 40-41 
logical operators 
and,78-79 
not, 77-78 
or, 79 

OverView, 74 
Longevity program 

creating Entry widget, 303-304 
creating Text widget, 304 
OverView, 301-302 

placing widget with Grid layout manager, 
302-303 
setting up, 302 
text-based widgets, 304-306 


wrapping up, 306 
loop variable, 197 
looping 
music, 376 
sounds, 374-375 
through files, 196-197 
through tuple elements, 111-112 
Loopy String program 
for loops 

creating, 90 
OverView, 89-90 
OverView, 88-89 
lose() method, 279 
Losing Battle program 

creating conditions that can become false, 
69 

OverView, 66-68 
tracing, 68 

lower() method, 37, 38t 

M 

Mad Lib program 

class constructor method, 315 
create_widgets() method, 315-317 
importing tkinter module, 314 
mainloop() method, 318-319 
OverView, 285-286 
tell_story() method, 317-318 
main() function 

AstrocrashOl program, 381-382 
Astrocrash08 program, 408 
Blackjack game, 282-283 
Critter Caretaker program, 244 
Pizza Panic game, 359 
Tic-Tac-Toe game, 186-187 
Trivia Challenge game, 213-215 
mainloop() method 

GUI programs, 292, 318 
Mad Lib program, 318-319 
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New Graphics Window program, 326, 326t 
Pizza Panic game, 358 
Screen class, 413t 
Maitre D’ program 

interpreting any value as true or 
false, 71-72 
OverView, 70-71 
master, defined, 293 
math module, 384 
mathematical operators, 29-30 
MAX_VEL0C1TY class constant, 407 
Message Analyzer program 
len() function, 95 
in operator, 95 
OverView, 94 
Message class 

adding to screen, 340 
creating, 339-340 
games module, 325t 
OverView, 412t, 417 
messages 
displaying 

importing color module, 339 
Message object, 339-340 
OverView, 337-339 
using screen width and height, 340 
OverView, 248-249 
receiving, 251 
sending, 251 
methods 

altering behavior of inherited 
creating Base class, 263 
invoking Base class methods, 264-265 
overriding Base class methods, 264 
OverView, 262-263 
using derived classes, 265-266 
defining 

to create widgets, 297-298 
OverView, 221 


invoking, 37, 222 
OOP, 219 
Missile class 

_init_() method, 388-389 

die() method, 393 
modifying, 398 
OverView, 387-388 
update() method, 389-390, 393 
modules 
defined, 52 
importing, 269-270 
OverView, 267-268 

using imported functions and classes, 270 
writing, 268-269 
modulus operator (%), 29 
Monty Python, 3 
Mood Computer program 
elif clause, 62-63 
OverView, 59-62 
mood property, 242-243 
moon_weight function, 46 
Mouse class, 412t, 418-419 
mouse input 

grabbing input to graphics window, 348 
OverView, 345-346 
reading x- and y-coordinates, 347 
setting pointer visibility, 347-348 
mouse object, 325t 
Movie Chooser program 

allowing master to be only reference, 
307-308 
check buttons 

creating, 308-309 
getting status of, 310 
OverView, 306-307 
setting up, 307 
wrapping up, 310 
Movie Chooser 2 program 
OverView, 311 
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radio buttons 

creating, 312-313 

getting value from group of, 313-314 
setting up, 311-312 
wrapping up, 314 
Moving Pan program 

grabbing input to graphics window, 348 
OverView, 346 

reading x- and y-coordinates, 347 
setting pointer visibility, 347-348 
setting up, 346-347 
wrapping up, 348 
multiple inheritance, 256 
multiplication operator (*), 29t 
music 

loading, 375-376 
looping, 376 
playing, 376 
stopping, 376 
theme, 401-408 
Music class, 412t, 419 
mutabili ty 
defined, 100 
list, 126 

N 

\n (newline character), 23, 24t, 195,198 
“n” shelf access mode, 204 
n_repeats attribute, 371, 417t 
NameError exception type, 207t 
negative position numbers, 98-99 
nested function calls, 43 
nested sequences 

accessing nested elements, 135 

creating, 134-135 

dealing with invalid choice, 137 

OverView, 133-134 

scores, 137 

unpacking, 136 

waiting for user, 138 


nested tuples 

adding scores by appending, 137 
displaying scores by accessing, 137 
New Graphics Window program 
importing games module, 324-325 
initializing graphics screen, 325 
OverView, 324 
starting main loop, 326 
new_board() function, 177t, 180 
newline character (\n), 23, 24t, 195,198 
next_block() function, 213, 215 
next_line() function, 212-213 
next_turn() function, 177t, 185-186 
No Vowels program 

creating constants, 102-103 
creating new strings from existing ones, 
103-104 

OverView, 101-102 
not logical operator, 77-78 
not-equal-to comparison operator (!=), 56t 
number sign s 5 Tnbol (#), 12-13 
numbers 

mathematical operators, 29-30 
numeric types, 28-29 
OverView, 27-28 
random 

importing random module, 51-52 
OverView, 50-51 
randint() function, 52 
randrange() function, 52-53 

o 

Object-Oriented programming (OOP) 

See also Software objects 
altering behavior of inherited methods 
creating Base class, 263 
involdng Base class methods, 264-265 
overriding Base class methods, 264 
OverView, 262-263 
using derived classes, 265-266 
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Blackjack game 

BJ_Card class, 275-276 
BJ_Dealer class, 279 
BJ_Deck class, 276 
BJ_Game class, 279-282 
BJ_Hand class, 276-278 
BJ_Player class, 278-279 
cards module, 271-273, 275 
designing classes, 273-274 
games module, 275 
main() function, 282-283 
writing pseudocode for game loop, 
274-275 

combining objects 

combining Card objects using Hand 
object, 255-256 
creating Card class, 252-253 
creating Hand class, 253-254 
OverView, 251-252 
using Card objects, 254 
inheritance 

creating classes, 256 
extending classes through, 256-262 
messages 

OverView, 248-249 
receiving, 251 
sending, 251 
modules 

importing, 269-270 
OverView, 267-268 

using imported functions and classes, 
270 

writing, 268-269 
OverView, 3-4 
polymorphism, 267 
objects. See Software objects 
odds_change object attribute, 357 
OOP. See Object-Oriented programming (OOP); 
Software objects 
open() function, 193 


open_file() function, 212 

opening files, 193 

operator overloading, 41 

or logical operator, 79 

overlapping_sprites property, 334t, 414t 

overlaps() method, 415t 

overriding methods, defined, 262 

P 

Pan class 

_init_() method, 353-354 

clieck_catch() method, 354-355 
loading Pan image, 353 
update() method, 354 

parameters, receiving information through, 
163-164 

_pass_time() method, 242-243 

passing, defined, 8 
Password program 

comparison operators, 55-56 
creating conditions, 55 
if statement, 55, 57 
OverView, 53-54 

using indentation to create blocks, 56-57 
Personal Greeter program 
input() function, 34-35 
OverView, 33 
pessimism, 146 
pickle functions, 203t 
Piclde It program 
OverView, 200 
pickling data, 200-202 
shelves 

using to retrieve pickled data, 204-205 
using to store pickled data, 203-204 
unpickling data, 202-203 
piclde module, 201 
pickle.dump() function, 201 
pickle.load() function, 202 
pickling data, 200-205 
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pieces() function, 177t, 179-180 
pixels, 325 
Pizza class 

_init_() method, 355 

end_game() method, 356 
handle_caught() method, 356 
update() method, 355-356 
Pizza Panic game 
Chef class 

_init_() method, 357 

check_drop() method, 358-359 
OverView, 356-357 
update() method, 357-358 
main() function, 359 
OverView, 321-322 
Pan class 

_init_() method, 353-354 

check_catch() method, 354-355 
loading Pan image, 353 
update() method, 354 
Pizza class 

_init_() method, 355 

end_game() method, 356 
handle_caught() method, 356 
update() method, 355-356 
setting up, 352-353 
Pizza Slicer program 
creating slices, 107-108 
creating tuples, 108 
none value, 106 
OverView, 104-106 
slicing shorthand, 108 
slicing strings, 106-107 
Pizza Sprite program 
OverView, 330-331 
sprites 

adding to screen, 333-334 
creating, 333 

loading image for, 331-333 


plain text files, 190 
planning programs 

applying stepwise refinement to 
algorithms, 81 
Astrocrash game 
assets, 378 
features, 377-378 

creating algorithms with pseudocode, 80- 
81 

Guess My Numher game, 81-82 
Tic-Tac-Toe game 

creating list of functions, 177 
OverView, 175 

representing data, 176-177 
writing pseudocode, 176 
Word Jumble game, 117 
platform independence, 4 
play() method, 244 

Blackjack game, 281-282 
Critter Caretaker program, 244 
Game class, 402 
Music methods, 419t 
sound object, 374, 421t 
Player class, 269 
player.is_hitting() method, 281 
Pla 5 dng Gards program 

combining Card objects using Hand object, 
255-256 

creating Gard class, 252-253 
creating Hand class, 253-254 
OverView, 251-252 
using Card objects, 254 
Pla 5 dng Gards 2.0 program 
creating Base class, 257-258 
extending derived classes, 259-260 
inheriting from Base class, 258—259 
OverView, 256-257 
using derived classes, 260-262 
Pla 5 dng Gards 3.0 program 
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Base class methods 
invoking, 264-265 
overriding, 264 
creating Base class, 263 
OverView, 262-263 
using derived classes, 265-266 
pointer visibility, 347-348 
polymorphism, 267, 281 
pop() list method, 132t 
populate() method, 260 
position property, 414t, 418t 
positional arguments, 168-169 
positional parameters, 167-169 
positive position numbers, 97-98 
print() function 

Game Over program, 13-14 
OverView, 8 

printing multiple values, 19 
specilying final string to print, 19-20 
printing 

backslashes, 22-23 
multiple values, 19 
names 

five times, 46 

lowercase and uppercase versions of, 45 
objects, 228 

specitying final string to print, 19-20 
tuples, 111 
private attribute s 
accessing, 234-235 
creating, 234 
OverView, 233 
Private Critter program 
OverView, 233 
privacy 

respecting, 237 
when to implement, 237 
private attributes 
accessing, 234-235 
creating, 234 


private methods 

accessing, 236-237 
creating, 235-236 
private methods 
accessing, 236-237 
creating, 235-236 
OverView, 233 

programmer-created functions, 161 
properties 

accessing, 240-241 
creating, 238-240 
Property Critter program 
OverView, 238 
properties 

accessing, 240-241 
creating, 238-240 
©property decorator, 239 
pseudocode 

creating algorithms with, 80-81 
defined, 80 
Tic-Tac-Toe game, 176 
writing for game loop, 274-275 
pseudorandom generation, 50 
public attributes, 233, 242 
public_method() method, 233, 236 
pushing, 248 
■py extension, 11 
py3e_software file, 409 
py3e_source.zip file, 409 
pygame package, 323 
Python 

advantages of 
community, 4 
ease of use, 3 
free and open source, 5 
integration with other languages, 4 
Object-Oriented programming, 3-4 
platform independence, 4 
power, 3 
IDLE 
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interactive mode, 7-9 
script mode, 10-12 
setting up 

on other operating systems, 6-7 
on Windows, 5-6 
Python Shell, 7f, 8 
Python Tutor mailing list, 4 
Python wehsite, 6 
Python Windows Installer, 5, 6f 

Q 

quit() screen method, 326t, 413t 
Quotation Manipulation program 

creating new strings with string methods, 
36-38 

OverView, 35-36 
quotes 

inserting, 23 

OverView, 16-18 

printing multiple values, 19 

specifying final string to print, 19-20 

triple-quoted strings, 20-21 

using inside strings, 18-19 

R 

“r” shelf access mode, 204 
Radio hutton element, 288t 
radio buttons 

creating, 312-313 

getting value from group of, 313-314 
OverView, 311 

randint() fnnction, 52-53, 83 
random access, defined, 95-96 
Random Access program 

negative position numbers, 98-99 
OverView, 96-97 

positive position numbers, 97-98 
random module, 99 

random module, 51-52, 83, 99, 267, 379 


random numbers 

importing random module, 51-52 
OverView, 50-51 
randint() function, 52 
randrange() function, 52-53 
random.choice() function, 116,152 
random.randrange() function, 99 
random.shuffle() method, 261 
randrange() function, 52-53, 270 
range() function, 90-93 
“rb” binary file access mode, 201t 
“rb+” binary file access mode, 2011 
read() file object method, 194 
read access, providing to private attributes, 
239 

Read It program 

looping through files, 196-197 
opening and closing files, 193 
OverView, 190-192 
reading all lines into lists, 196 
reading characters 
from files, 194 
from lines, 195 
Read Key program 
OverView, 363 
setting up, 364 

testing for keystrokes, 364-365 
wrapping up, 365 
read([size]) file object method, 

199t 

read_global() function, 174 
read_it.txt file argument, 193 
reading from text files 

looping through files, 196-197 
opening and closing files, 193 
OverView, 190-192 
reading all lines into lists, 196 
reading characters 
from files, 194 
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from lines, 195 
readline() method, 195-196 
readline([size]) file object method, 199t 
readlines() file object method, 199t 
Receive and Return program 
encapsulation, 165 
OverView, 162-163 

receiving and returning values in same 
function, 165-166 

receiving information through parameters, 
163-164 

returning information through return 
values, 164 

Software reuse, 166-167 
receiving messages, 251 
remove() list method, 131,132t 
remove(sprite) screen method, 413t 
repeated code, 386 
repeating strings, 26-27 
repetition operator (*), 26-27 
replace() method, 37, 38t 
return values, returning information 
through, 164 
returning, defined, 8 
reveal() method, 304 
reverse() list method, 132t 
right property, 334t, 414t 
Romance checkbutton, 309 
root window 
creating, 291 

entering event loop, 292, 294, 296 
importing tldnter module, 291 
modifying, 291-292 
OverView, 289-290 
Rotate Sprite program 
OverView, 366-367 
using angle property, 368 
row parameter, 303 
rowspan parameter, 303 


s 

scale_image() function, 420t 

scopes, 171-172 

scores 

adding, 130,137 
displaying, 130,137 
removing, 131 
sorting, 131-132 
screen boundaries 

deriving classes from sprites, 344 
overriding update() method, 344-345 
OverView, 342-343 
Screen class, 412-413, 412t 
screen object, 325t 
script mode, IDLE 

running programs, 11-12 
saving programs, 11-12 
writing programs, 10 
self parameter, 221, 226-227 
self-documenting code, 32 
self.update_text() method, 309 
sending messages, 251 
sentry variable 
checking, 65-66 
initializing, 65 
updating, 66 

sequence operators and functions 
len() function, 95 
in operator, 95 
OverView, 93-94 
sequences, defined, 88 
sequential access, defined, 95 
set_angle() method, 414t 
set_background(new_background) screen 
method, 413t 

set_bottom() method, 415t 
set_color method, 416t 
set_dx() method, 415t 
set_dy() method, 415t 
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set_event_grab(new_status) screen method, 
413t 

set_image() method, 414t 
set_interval() method, 415t 
set_is_collideable() method, 415t 
set_is_visible(), 419t 
set_left() method, 415t 
set_position() method, 415t, 419t 
set_right() method, 415t 
set_size() method, 416t 
set_top() method, 415t 
set_value method, 416t 
set_velocity() method, 415t 
set_x() method, 414t, 418t 
set_^() method, 414t, 419t 
shadow_global() function, 174 
shared references, 138-140 
shelve module, 201 
shelve.open() function, 203 
shelves 

using to retrieve pickled data, 204-205 
using to store pickled data, 203-204 
Shinners, Pete, 323 
Ship class 

constructor method, 391, 407 
die() method, 394, 407 
modifying, 398 
OverView, 382-383, 391 
update() method, 385-387, 391-392, 394, 
407 

variable and constant, 384, 407 
side effects, 183 
Silly Strings program 

concatenating strings, 25-26 
line continuation character, 26 
OverView, 24-25 
repeating strings, 26-27 
simple conditions, 74 
Simple Critter program 


defining classes, 220-221 
instantiating objects, 222 
methods 

defining, 221 
invoking, 222 
OverView, 220 
Simple Game program 
modules 

importing, 269-270 
writing, 268-269 
OverView, 267-268 
using imported classes, 270 
Simple GUI program 

importing tkinter module, 291 
OverView, 289-290 
root window 
creating, 291 
entering event loop, 292 
modifying, 291-292 
sin() function, 385 

single quote escape character (\’), 23, 24t 
size property, 416t 
sk_number() function, 269 
slices 

creating, 107-108 
defined, 104 
list 

assigning new, 127 
deleting, 128 
slicing 

defined, 104 
lists, 125-126 
OverView, 107f 
strings 

creating slices, 107-108 
none value, 106 
OverView, 104-107,109-110 
slicing shorthand, 108 
tuples, 108,110-112 
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tuples, 114-115,115f 
Slippery Pizza program 

detecting collisions, 350-351 
handling collisions, 351 
OverView, 349-350 
setting up, 350 
wrapping up, 351-352 
Software objects 
attributes 

accessing, 227-228 
controlling access, 238-241 
initializing, 226-227 
OverView, 225-226 
printing, 228 
class attributes 
accessing, 231 
creating, 230 
OverView, 228-230 
classes, defining, 220-221 
constructors 
creating, 224 
creating multiple, 224 
OverView, 222-223 
Critter Caretaker program 

creating menu system, 244-245 
Critter class, 242-244 
OverView, 217-219, 241 
starting, 245 
encapsulation, 232-233 
instantiating objects, 222 
methods 

defining, 221 
invoking, 222 
OverView, 217, 219 
privacy 

accessing private attributes, 234-235 
accessing private methods, 236-237 
creating private attributes, 234 
creating private methods, 235-236 
OverView, 233 


respecting, 237 
when to implement, 237 
static methods 

creating, 231-232 
involdng, 232 
OverView, 228-230 
Software reuse, 166-167 
sort() list method, 131-132,132t 
Sound and Music program 
music 

loading, 375-376 
looping, 376 
playing, 376 
stopping, 376 
OverView, 372 
sounds 

loading, 373 
looping, 374-375 
playing, 373-374 
stopping, 375 
wrapping up, 377 
sounds 

loading, 373 
looping, 374-375 
playing, 373-374 
stopping, 375 
System hell, 23-24 

Sprite class, 325t, 334t, 412t, 413-415 
sprites 

adding to screen, 333-334 
creating, 333 
defined, 330 

deriving classes from, 344 
loading images for, 331-333 
moving, 340-342 
OverView, 329-331 
rotating 

angle property, 368 
OverView, 366-367 
statements, defined, 9 
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static methods 
creating, 231-232 
invoking, 232 
OverView, 228-230 
status() method, 231 
stepwise refinement, defined, 81 
sticky parameter, 303 
still_playing property, 279-280 
stop() method, 375, 419t, 421t 
storing, defined, 138 
storing complex data in files 
OverView, 200 
pickling data, 200-202 
shelves 

using to retrieve piclded data, 204-205 
using to store piclded data, 203-204 
unpickling data, 202-203 
str() function, 43t 

_str_() method 

Playing Cards program, 254 
Playing Cards 3.0 program, 265 
Simple Game program, 269 
string literals, defined, 9 
string methods 

creating new strings with, 36-38 
defined, 36 
OverView, 35-36 
strings 
building 

creating constants, 102-103 
from existing ones, 103-104 
OverView, 101-102 
concatenating, 25-26 
converting to integers, 42-43 
creating strings with string methods, 36-38 
defined, 8-9 

immutability of, 100-101 
indexing 

negative position numbers, 98-99 


OverView, 95-97 

positive position numbers, 97-98 
random module, 99 
printing, 13-14 
repeating, 26-27 
slicing 

creating slices, 107-108 
none value, 106 
OverView, 104-107,109-110 
slicing shorthand, 108 
tuples, 108,110-112 
using escape sequences with 

inserting newline character, 23 
inserting quotes, 23 
moving forward one tab stop, 21-22 
OverView, 21 

printing backslashes, 22-23 
sounding system bell, 23-24 
using quotes with 

creating triple-quoted strings, 20-21 
OverView, 16-18 
printing multiple values, 19 
specifying final string to print, 19-20 
using quotes inside strings, 18-19 
using sequence operators and fimctions 
with 

len() function, 95 
in operator, 95 
OverView, 93-94 
writing lists of to files, 198-199 
writing to files, 197-198 
StringVar class, 312 
strip() method, 38t 
subtraction operator (-), 29t 
sun_weight function, 46 
super() function, 354 
superclass constructor, 399 
superclasses, 265 
swapcase() method, 38t 
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s 5 Tic() method, 204 
syntax highlighting, 9 
SyntaxError exception lype, 207t 
sys.exit() function, 212 
System bell character (\a), 23, 24t 
System bell, sounding, 23-24 

T 

tab escape sequence (\t), 22, 24t 
tab stops, moving forward one, 21-22 
talk() method, 220, 222, 234, 243 
tell_story() method, 317-318 
text, displaying 

importing color module, 336 
OverView, 335-336 
Text object 

adding to screen, 337 
creating, 336-337 
Text box class, 412t 
Text box element, 288t 
Text class, 325t, 416 
Text entry element, 288t 
Text object 

adding to screen, 337 
creating, 336-337 
Text widget, 304 
text_file variable, 193 
Three-Year-Old Simulator program 
OverView, 63-64 
sentry variables 
checking, 65-66 
initializing, 65 
updating, 66 
while loops, 64-65 
tick() method, 415t 
Tic-Tac-Toe game 
OverView, 157-158 
planning 

creating list of functions, 177 
OverView, 175 


representing data, 176-177 
writing pseudocode, 176 
setting up 

ask_number() function, 179 
ask_^es_no() function, 179 
computer_move() function, 183-185 
congrat_winner() function, 186 
display_board() function, 180 
display_instruct() function, 178-179 
human_move() function, 182-183 
legal_moves() function, 180-181 
main() function, 186-187 
new_board() function, 180 
next_turn() function, 185-186 
pieces() function, 179-180 
winner() function, 181-182 
starting, 187 

time_til_drop object attribute, 357-358 
title() method, 37, 38t, 291 
tkinter module, 287, 291, 297, 314 
Tldnter program, 289 
top property, 334t, 414t 
total attribute, 229 
tracing programs, 68 
transparency, loading images with, 332 
trapping exceptions, 207t 
triple-quoted strings, 20-21,161 
Trivia Challenge game 
asking question, 214 
checking answer, 215 
data file layout 

next_block() function, 213 
next_line() function, 212-213 
open_file() function, 212 
OverView, 210-212 
welcome() function, 213-214 
ending game, 215 
getting answer, 214 
getting next question, 215 
main() function, 215 
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OverView, 189-190 
setting up, 214 
true division, 29 
true division operator (/), 29t 
True value, 62-63, 65, 68-71 
Trust Fund Buddy program 

converting strings to integers, 42-43 
OverView, 38-42 

tracking down logical errors, 40-41 
using augmented assignment operators, 44 
tiy statement, 206, 209 
tuples 

concatenating, 115-116 
creating 

with elements, 111 
empty, 110 
OverView, 108 
defined, 108 
immutability of, 115 
indexing, 114 

looping through elements of, 111-112 
nested 

adding scores by appending, 137 
displaying scores by accessing, 137 
OverView, 112-113 
printing, 111 
slicing, 114-115 
treating as condition, 110 
using in operator with, 114 
using len() function with, 113-114 
when to use lists instead of, 133 
TypeError exception type, 207t 

u 

underscore characters (_), 234 
Unified Modeling Language (UML), 250 
unpacking nested sequences, 136 
unpickling data, 202-203 
update() method 
Asteroid class, 381 


Astrocrash game, 364 
Chef class, 357-358 
Collider class, 397 
Missile class, 389-390, 393 
overriding, 344-345 
Pan class, 354 
Pizza class, 355-356 
Ship class, 385-387, 391-392, 394, 407 
sprites, 334t, 415t 
Wrapper class, 396 
update_count() method, 300 
update_text() method, 309-310 
updating sentry variables, 66 
upper() method, 36, 38t 
Useless Trivia program 

calculating moon_weight and sun_weight, 
46 

calculating seconds, 46 
comments, 44-45 
OverView, 15-16 
printing names 
five times, 46 

lowercase and uppercase versions of, 45 
User input, 45 
waiting for user, 46 
User input 

input() function, 34-35 
OverView, 33 

Useless Trivia program, 45 

V 

value property, 337t 
text, 416t 

ValueError exception type, 207t 
values 

default parameter, 169-171 
dictionary, 140-142 
printing multiple, 19 
setting initial, 83 
treating as conditions 
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interpreting any value as true or false, 
71-72 

OverView, 69-71 

values() dictionaiy method, 148t 
van Rossum, Guido, 3 
variable option, 313 
variables 
creating, 31 
defined, 31 
initializing, 152 
naming, 32 
OverView, 30-31 
using, 31 
vectors, 112 
velocity property, 414t 
VELOCnY_MAX class constant, 407 

w 

“w” shelf access mode, 204 

WAV format, 373 

“wb” binaiy file access mode, 2011 

“wb+” binary file access mode, 201t 

websites 

companion, 5, 409-410 
Python, 6 

welcome() function, 213-214 
while loops 

High Scores program, 129-130 
OverView, 63-65 
sentry variables 
checking, 65-66 
initializing, 65 
updating, 66 

Trivia Challenge game, 214 
Word Jumble game, 118 
widgets 

defined, 292 

defining methods to create, 297-298 
Entiy, 303-304 
event handlers and 


binding, 300 
creating, 300 
OverView, 298-299 

getting and inserting text with, 304-306 
placing with Grid layout manager, 302-303 
Text, 304 

width property, 326t, 412t-413t 
Windows, installing Python on, 5-6 
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